Gewusst wie: Ändern des Workflows eines Arbeitsaufgabentyps

Artikel
08/20/2008

Aktualisiert: November 2007

Sie können den Workflow eines Arbeitsaufgabentyps ändern, indem Sie die XML-Datei exportieren und ihren Inhalt bearbeiten. Sobald Sie den Workflow geändert haben, können Sie die XML-Datei importieren und den aktualisierten Arbeitsaufgabentyp verwenden.

Erforderliche Berechtigungen

Um diese Schritte ausführen zu können, müssen Sie Mitglied der Gruppe Team Foundation-Administratoren oder der Gruppe Projektadministratoren für das Projekt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

So ändern Sie den Arbeitsablauf

Wenn Sie einen Arbeitsaufgabentyp für ein einzelnes Projekt ändern, führen Sie witexport aus, um die XML-Datei für den zu ändernden Arbeitsaufgabentyp zu exportieren. Weitere Informationen finden Sie unter Gewusst wie: Exportieren eines Arbeitsaufgabentyps aus einem vorhandenen Projekt.
Klicken Sie in Visual Studio auf Datei, auf Öffnen und dann auf Datei.

Dadurch wird das Dialogfeld Datei öffnen angezeigt.

Wechseln Sie unter Suchen in zu dem Verzeichnis, in das Sie die Datei exportiert haben.

Wenn Sie einen Arbeitsaufgabentyp ändern, um eine Prozessvorlage anzupassen, navigieren Sie zu dem Speicherort, an den Sie die Vorlage heruntergeladen haben.

Hinweis:
Unter Windows Vista haben Sie möglicherweise für bestimmte Ordner keine Zugriffsrechte. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Zugriffsrechte besitzen, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=92325 und https://go.microsoft.com/fwlink/?LinkId=92323. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Zugriffsrechte verfügen.

Unter Windows Vista haben Sie möglicherweise für bestimmte Ordner keine Zugriffsrechte. Wenn Sie versuchen, den Arbeitsaufgabentyp an einen Speicherort zu exportieren, für den Sie keine Zugriffsrechte besitzen, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=92325 und https://go.microsoft.com/fwlink/?LinkId=92323. Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Zugriffsrechte verfügen.

Wählen Sie die zu aktualisierende XML-Datei für den Arbeitsaufgabentyp aus, und klicken Sie dann auf Öffnen. Klicken Sie in der Eingabeaufforderung für Zeilenenden auf Nein.

Suchen Sie die Definition des Arbeitsablaufs für den Arbeitsaufgabentyp in der XML-Datei im Abschnitt <WORKFLOW>, wie im nachfolgenden XML dargestellt:

<WORKFLOW>
  <STATES>
    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Fügen Sie der Typdefinition den Zustand Unapproved hinzu, indem Sie ein weiteres <STATE>-Element einfügen. Der neue Zustand wird in fett formatiertem Text angezeigt.

<WORKFLOW>
  <STATES>
    <STATE value="Unapproved">    </STATE>    <STATE value="Active">
      <FIELDS>
        <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
          <EMPTY />
        </FIELD>
        <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
...

Erstellen Sie einen Übergang zwischen dem Zustand NULL und dem Zustand Unapproved. Suchen Sie dazu zunächst den Abschnitt der Arbeitablaufdefinition für Übergänge. Fügen Sie anschließend das nachfolgende XML ein (Fettformatierung). Durch diese Änderung wird allen neuen Arbeitsaufgaben dieses Typs zunächst der Zustand Unapproved mit dem Standardgrund New zugewiesen.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>  </TRANSITION>  <TRANSITION from="" to="Active">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
    <FIELDS>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
        <COPY from="currentuser" />
      </FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <COPY from="clock" />
      </FIELD>
      <FIELD refname="System.AssignedTo">
        <COPY from="currentuser" />
      </FIELD>
    </FIELDS>
  </TRANSITION>

Löschen Sie den Übergang zu Active, der in dem folgenden XML-Code hervorgehoben dargestellt wird. Dies ist notwendig, da nur ein Anfangsübergang zulässig ist.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
    </REASONS>
  </TRANSITION>
  <TRANSITION from="" to="Active">    <REASONS>      <DEFAULTREASON value="New" />    </REASONS>    <FIELDS>      <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">        <COPY from="currentuser" />      </FIELD>      <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">        <COPY from="clock" />      </FIELD>      <FIELD refname="System.AssignedTo">        <COPY from="currentuser" />      </FIELD>    </FIELDS>  </TRANSITION>

Fügen Sie für den Anfangsübergang den Grund "Ported" hinzu, indem Sie den folgenden XML-Code einfügen (Fettformatierung). So können Benutzer erkennen, ob es sich um eine neue Arbeitsaufgabe handelt oder ob die Arbeitsaufgabe von einem anderen Verfolgungssystem portiert wurde.
```
<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />    </REASONS>
  </TRANSITION>
...
```

Fügen Sie folgende, in fett formatiertem Text dargestellte COPY-Regel ein. Diese Regel legt das Feld Zugewiesen an auf den Benutzer fest, der die Arbeitsaufgabe erstellt hat, und wird nur während des Anfangsübergangs ausgewertet.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>       <FIELD refname="System.AssignedTo">         <COPY from="currentuser" />       </FIELD>    </FIELDS>
  </TRANSITION>
...

Hinweis:
Durch das Einfügen dieser Regel in andere <TRANSITION>-Elemente oder <STATE>-Elemente wird die Regel auf andere Übergänge oder Zustände ausgeweitet. Weitere Informationen finden Sie unter Verwenden der Regeln <WHEN*>, <DEFAULT> und <COPY>.

Erstellen Sie einen Übergang vom Zustand Unapproved in den Zustand Active, indem Sie den markierten XML-Code aus dem folgenden Beispiel einfügen. Aufgrund dieser Änderung kann dieser Übergang für die Arbeitsaufgabe nach ihrer Genehmigung stattfinden.

<TRANSITIONS>
  <TRANSITION from="" to="Unapproved">
    <REASONS>
      <DEFAULTREASON value="New" />
     <REASON value="Ported" />
    </REASONS>
    <FIELDS>
       <FIELD refname="System.AssignedTo">
         <COPY from="currentuser" />
       </FIELD>
    </FIELDS>
  </TRANSITION>
  <TRANSITION from="Unapproved" to="Active">    <REASONS>      <DEFAULTREASON value="Approved" />    </REASONS>  </TRANSITION>  <TRANSITION from="Active" to="Closed">
    <REASONS>
      <DEFAULTREASON value="Completed" />
      <REASON value="Deferred" />
      <REASON value="Obsolete" />
      <REASON value="Cut" />
    </REASONS>
...

Klicken Sie auf der Symbolleiste auf Speichern, um die Änderungen in der XML-Datei zu speichern.
Informationen zum Importieren des neuen Arbeitsaufgabentyps in ein einzelnes Projekt finden Sie unter Gewusst wie: Importieren eines Arbeitsaufgabentyps in ein vorhandenes Projekt. Informationen zum Hinzufügen des Arbeitsaufgabentyps zur Prozessvorlage finden Sie unter Arbeitsaufgabentypen.

So überprüfen Sie die in ein einzelnes Projekt importierten Änderungen

Klicken Sie in Team Explorer auf Aktualisieren, um die neuesten Aktualisierungen vom Server herunterzuladen.

Diese Aktualisierungen enthalten die soeben importierten Änderungen. Warten Sie einige Sekunden, bis der Knoten Arbeitsaufgaben geladen wurde. Auf Knoten, auf denen noch ein Ladevorgang ausgeführt wird, wird In Arbeit angezeigt.
Erstellen Sie mithilfe des geänderten Arbeitsaufgabentyps eine neue Arbeitsaufgabe. Klicken Sie dazu mit der rechten Maustaste auf den Knoten Arbeitsaufgaben, zeigen Sie auf Arbeitsaufgabe hinzufügen, und klicken Sie dann auf den Arbeitsaufgabentyp.

Diese Arbeitsaufgabe wird aus dem von Ihnen geänderten und importierten Arbeitsaufgabentyp erstellt.
Beachten Sie, dass der ursprüngliche Zustand jetzt Unapproved ist und dass der Grund auf New festgelegt wird. Außerdem ist der Zugewiesen an-Wert auf Ihren Kontonamen festgelegt. Klicken Sie auf das Feld Grund, um ein Listenfeld mit dem New-Grund und dem Ported-Grund anzuzeigen.
Geben Sie im Feld Titel einen Titel ein, und klicken Sie auf Speichern, um die Arbeitsaufgabe zu speichern. Warten Sie, bis der Speichervorgang beendet ist, wie durch Gespeicherte(s) Element(e) auf der Statusleiste angegeben wird.
Wählen Sie im Feld Zustand den Wert Active aus, um die Arbeitsaufgabe zu genehmigen und den Übergang erneut auszuführen. Beachten Sie die Festlegung des Felds Grund auf Approved.
Klicken Sie auf der Symbolleiste auf Speichern, um diesen Übergang zu speichern.
Klicken Sie auf Schließen, um die Arbeitsaufgabe zu schließen.

Siehe auch

Konzepte

Zustände, Übergänge und Gründe

Übergangssicherheit

Beschränken der Reichweite von Feldregeln nach Zustand, Übergang oder Grund

Weitere Ressourcen

Automatisieren von Zustandsübergängen

Freigeben über