Abfragen von Zuweisungs- oder Workflowänderungen in Azure Boards


Datentyp

Unterstützte Operatoren und Makros


Boolescher Wert1

= , <> , =[Feld] , <> [Feld]


DateTime

= , <> , , , = , = , ><>< =[Field], <> [Field], >< [Field], [Field], > =[Field], < =[Field], In, Not In, Was Ever
Makros:@Today, @Today +/- n gültig mit einem beliebigen DateTime-Feld


Identität

= , <> , , , = , = , ><>< =[Field], <>> [Field], < [Field], [Field], > =[Field], < =[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever
Makros:@me für alle Identitätsfelder gültig.


Einzelner Text (Zeichenfolge)2

= , <> , , , = , = , ><>< =[Field], <>> [Field], < [Field], [Field], > =[Field], < =[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever


Hinweis

  1. Das boolesche Datentypfeld wird für TFS 2017 und höhere Versionen unterstützt.
  2. Der Was Ever-Operator ist derzeit nur für Kanban-Boardspalten für Azure DevOps Services gültig.

Verwenden Sie die Operatoren In und Not In, um nach zwei oder mehr Auswahllisteneinträgen oder einem durch Trennzeichen getrennten Satz von Elementen zu filtern oder auszuschließen. Verwenden Sie die Operatoren In Gruppe oder Nicht in Gruppe, um nach Elementen zu filtern, die zu einer Kategoriegruppe oder Sicherheitsgruppe gehören oder nicht gehören. Weitere Informationen finden Sie unter Abfragen von Feldern, Operatoren und Makros.

Identitätsbasierte Abfragen

Verwenden Sie das Suchfeld oder den Abfrage-Editor, um Arbeitselemente basierend auf einer Zuweisung zu einem Identitätsfeld schnell zu finden. Außerdem können Sie nach Arbeitselementen filtern, die darauf basieren, wer ein Arbeitselement geändert, aufgelöst oder geschlossen hat. Indem Sie einen Zeitraum angeben, können Sie Ihre Abfrage noch weiter eingrenzen, was bei der Leistung helfen kann.

Verwenden Sie = , um nach aktuellen Zuweisungen zu suchen, = Elemente basierend auf früheren Zuweisungen aufzulisten, und @Me, um den Bereich auf Ihre Benutzeridentität zu legen.

Filtern nach

Einschließen dieser Abfrageklauseln

Aktive Elemente, die mir zugewiesen sind

            Assigned To @Me

And State = Active

Geschlossene Elemente, die mir zu einem bestimmten Zeitpunkt zugewiesen wurden

            Assigned To Was Ever @Me

And State = Closed

Aktive User Storys, die meinem (Web)-Team zugewiesen sind

            Work Item Type = User Story

And State = Active

And Assigned To In Group [FabrikamFiber]\Web

Elemente, die ich in den letzten 30 Tagen geändert habe

            Changed By = @Me

And Changed Date >= @Today-30

Nicht zugewiesene Elemente (lassen Sie den Wert leer)

            Assigned To = _

Abfragen der Team- oder Gruppenmitgliedschaft

Um nach Elementen zu filtern, die einer Person zugewiesen sind, die zu einem Team oder einer Sicherheitsgruppe gehört, verwenden Sie den Operator In Gruppe.

Filter based on assignment to a TFS security group

Sie können die Operatoren In Gruppe oder Nicht in Gruppe verwenden, um eine Abfrage basierend auf mehreren Werten zu filtern, die Mitglieder einer Gruppe oder keine Mitglieder einer Gruppe sind. Beispiele für Gruppen, die Sie angeben können, sind die folgenden Elemente:

  • Teams
  • Integrierte und benutzerdefinierte Sicherheitsgruppen
  • Azure Active Directory und Active Directory-Sicherheitsgruppen
  • Arbeitselementkategorien

Abfragen basierend auf Workflowänderungen

Sie verwenden die Felder Status, Grund und Aufgelöster Grund, um Elemente basierend auf Workflowänderungen abzufragen.

Filtern nach

Einschließen dieser Abfrageklauseln

Aufgelöste Storys

            Work Item Type = User Story
And State = Resolved

Storys, Fehler und Aufgaben, die neu oder aktiv sind

            Work Item Type In User Story,Bug,Task
And State In New,Active

Elemente entfernt, wenn sie dupliziert werden

            State= Removed
And Reason = Duplicate

Nicht bestandene Akzeptanztests für Elemente

Resolved Reason = Acceptance tests fail

Elemente, die innerhalb der letzten 15 Tage geschlossen wurden

            State = Closed
And Closed Date > @Today-15

Workflowänderungen und identitätsbasierte Abfragen

Sie können Schnell nach Elementen suchen, die Sie geändert, aufgelöst oder geschlossen haben. Sie können auch Elemente finden, die von anderen Teammitgliedern geändert wurden. Mehrere Felder — wie Created By, Changed By, Resolved By und Closed By — werden basierend auf Änderungen am Workflow aufgefüllt.

Filtern nach

Einschließen dieser Abfrageklauseln

User Storys, die ich geschlossen habe

            Work Item Type = User Story
And Closed By = @Me

Elemente, die ich in der letzten Woche aufgelöst habe

            Resolved By = @Me
And Resolved Date >= Today-7

Abfragen von Änderungen im Arbeitselementzustand

Um Arbeitselemente aufzulisten, deren Status innerhalb eines bestimmten Datumsbereichs geändert wurde, können Sie das Feld State Change Date (Datum der Zustandsänderung) verwenden, um die Suche einzugrenzen und dann Klauseln für Änderungen im Feld State hinzuzufügen. In der folgenden Abbildung ist ein Beispiel angegeben.

Screenshot of Query Editor to query on State Change Date and State fields

Abfragen von Änderungen an einem Kanban-Board

Mithilfe der Kanban-Abfragefelder — BoardSpalte, Board Column Done und Board Lane — können Sie Arbeitselemente entsprechend ihrem Flowstatus auf dem Kanban-Board auflisten. Außerdem können Sie basierend auf diesen Abfragen ein Status- oder Trenddiagramm erstellen.

Hinweis

Kanban-Abfragefelder sind mit TFS 2015.1 oder höher verfügbar.

Sie können Elemente basierend auf dem Teambereichspfad auflisten, und wenn sie sich in einer bestimmten benutzerdefinierten Kanban-Spalte und einem bestimmten Verantwortlichkeitsbereich befinden. Wenn Sie eine Spalte oder einen Verantwortlichkeitslan umbenennen, müssen Sie die Abfragefilter entsprechend dem neuen Namen aktualisieren. Weitere Ideen finden Sie in diesem Blogbeitrag: New fields bring Kanban goodness to queries (Neue Felder bieten Kanban-Vorteile für Abfragen) und mehr.

Query filter on Kanban board fields

Hinweis

Abfragen werden jetzt standardmäßig auf das aktuelle Projekt bereichet. Überprüfen Sie die Abfrage zwischen Projekten, um Arbeitselemente zu finden, die in anderen Projekten in der Auflistung definiert sind.

Filtern nach

Einschließen dieser Abfrageklauseln


User Storys in der Spalte Code/Doing

Work Item Type = User Story
And Board Column = Code
And Board Column Done = False


Elemente im Verantwortlichkeitslan "Expedite"

Board Lane = Expedite


Elemente in einem beliebigen Verantwortlichkeitslane, dessen Bezeichnung "Test" enthält

Board Lane Contains Test


Elemente, die jemals in der Spalte "In Review" enthalten waren

Board Column Was Ever In Review

Wichtig

Arbeitselemente, die auf dem Kanban-Board mehrerer Teams angezeigt werden, können Ergebnisse liefern, die Nicht Ihren Erwartungen entsprechen, da jedes Team seine Kanban-Boardspalten und -Verantwortlichkeitsbereiche anpassen kann. Die Werte, die den Feldern Kanban Board Column, Board Column Doneund Board Lane zugewiesen sind, können sich von ihren Erwartungen unterscheiden, wenn ein anderes Team das Arbeitselement von einem anderen Board aktualisiert. Weitere Informationen finden Sie unter Hinzufügen, Überprüfen und Aktualisierenvon Arbeitselementen in Azure Boards .

Workflow- und Kanban-Boardfelder

Die folgenden Felder sind nützlich, um Abfragen zu filtern. Einige dieser Felder werden aktualisiert, wenn ein Arbeitselement von einem Zustand in einen anderen übergehen kann. Oder sie werden aktualisiert, wenn Sie ein Arbeitselement im Kanban-Board in eine andere Spalte oder einen anderen Verantwortlichkeitslan verschieben. Einige dieser Felder werden nicht im Arbeitselementformular angezeigt, aber sie werden für die in der folgenden Tabelle aufgeführten Arbeitselementtypen nachverfolgt.

Weitere Informationen zu Feldattributen finden Sie unter Arbeitselementfelder und -attribute.

Workflowfelder

Sie können die folgenden Felder verwenden, um Ihre Abfragen zu filtern oder Berichte zu erstellen. Einige dieser Felder werden mit Informationen aufgefüllt, wenn ein Arbeitselement von einem Zustand in einen anderen übergehen kann. Einige dieser Felder werden nicht im Arbeitselementformular angezeigt, aber sie werden für die in der folgenden Tabelle aufgeführten WITs nachverfolgt. Weitere Informationen zu Feldattributen finden Sie unter Arbeitselementfelder und -attribute.

Feldname

Beschreibung

Arbeitsaufgabentyp


Aktiviert durch 1, 2, 3

Der Name des Teammitglieds, das den Status eines Arbeitselements in den Kategoriestatus In Bearbeitung geändert hat.

Der Name des Teammitglieds, das den Status eines Arbeitselements von Neu in Aktiv geändert oder ein Arbeitselement reaktiviert hat, nachdem es geschlossen, abgeschlossen oder abgeschlossen wurde.

Verweisname=Microsoft.VSTS.Common.ActivatedBy
Datentyp=String (Identität)

Bug, Change Request, Epic, Feature, Issue, Product Backlog Item, Requirement, Review, Risk, Shared Step, Task, Test Case, User Story

Aktiviertes Datum 1, 3

Das Datum und die Uhrzeit, zu der das Arbeitselement in den Kategoriestatus In Bearbeitung geändert wurde.

Das Datum und die Uhrzeit, zu der das Arbeitselement von Neu in Aktiv geändert oder reaktiviert wurde, nachdem es geschlossen, abgeschlossen oder abgeschlossen wurde.

Verweisname=Microsoft.VSTS.Common.ActivatedDate
Datentyp=DateTime

All

Zugewiesen zu 2

Zugewiesen zu 2, 3, 4

Der Name des Teammitglieds, das das Arbeitselement derzeit besitzt. Weitere Informationen finden Sie in Hinweis 1 zu Synchronisierungs- und Personennamenfeldern.

Verweisname=System.AssignedTo
Datentyp=String (Identität)

All

Boardspalte

Die aktuelle Kanban-Boardspaltenzuweisung des Arbeitselements, z. B.: Aktiv, Geschlossen, Commit, Fertig oder andere benutzerdefinierte Spaltenzuweisung.

Verweisname=System.BoardColumn
Datentyp=Zeichenfolge

Anforderungskategorie 4

Anforderungskategorie 5

Boardspalte abgeschlossen

Die aktuelle Zuweisung des Arbeitselements zur Kanban-Spalte Doing (False) oder Done (True). Wird nur zugewiesen, wenn geteilte Spalten für eine Kanban-Boardspalte aktiviert sind.

Verweisname=System.BoardColumnDone
Datentyp=Boolean

Anforderungskategorie 4

Anforderungskategorie 5

Board Lane

Die aktuelle Kanban-Board-Verantwortlichkeitszuordnung des Arbeitselements, z. B. Default, Expedite, Blocked oder eine andere benutzerdefinierte Verantwortlichkeitszuweisung.

Verweisname=System.BoardLane
Datentyp=Zeichenfolge

Anforderungskategorie 4

Anforderungskategorie 5

Geschlossen von 1, 2

Geschlossen von 1, 2, 3

Der Name des Teammitglieds, das den Zustand auf "Geschlossen", "Abgeschlossen" oder "Fertig" festgelegt hat.

Verweisname=Microsoft.VSTS.Common.ClosedBy
Datentyp=String (Identität)

All

Geschlossen am

Das Datum und die Uhrzeit, zu der ein Arbeitselement abgeschlossen wurde.

Verweisname=Microsoft.VSTS.Common.ClosedDate
Datentyp=DateTime

All

Erstellt von 1, 2

Erstellt von 1, 2, 3

Der Name des Teammitglieds, das die Arbeitsaufgabe erstellt hat.

Verweisname='System.CreatedBy
Datentyp=String (Identität)

All

Erstellt am

Das Datum und Uhrzeit, zu der ein Arbeitselement erstellt wurde.

Verweisname=System.CreatedDate
Datentyp=DateTime

All

`Reason`

Ursache 3, 4

Der Grund für den aktuellen Status der Arbeitsaufgabe. Jeder Übergang von einem Workflowzustand zu einem anderen ist einem entsprechenden Grund zugeordnet.

Bei lokalen XML-Prozessmodellen werden die Ursachenwerte im WORKFLOW Abschnitt der Arbeitselementtypdefinition mithilfe des REASON -Elements definiert. Informationen zum Ändern der definierten Gründe finden Sie unter Ändern des Workflows für einen Arbeitselementtyp.

Verweisname=System.Reason
Datentyp=Zeichenfolge

Alle (außer Testfall und freigegebene Schritte)

Aufgelöst von 1, 2

Aufgelöst von 1, 2, 3

Der Name des Teammitglieds, das den Status eines Arbeitselements in den Status Aufgelöste Kategorie geändert hat.

Der Name des Teammitglieds, das den Status eines Arbeitselements in Den Workflowstatus Aufgelöst oder Abgeschlossen geändert hat.

Verweisname= Microsoft.VSTS.Common.ResolvedBy , Datentyp=Zeichenfolge (Identität)

All

Gelöst am

Aufgelöstes Datum 1, 2

Das Datum und die Uhrzeit, zu der das Arbeitselement in den Kategoriestatus In Aufgelöst geändert wurde.

Das Datum und die Uhrzeit, zu der das Arbeitselement in den Workflowzustand Aufgelöst oder Abgeschlossen verschoben wurde.

Verweisname= Microsoft.VSTS.Common.ResolvedDate , Datentyp=DateTime

All

Grund für Lösung

Aufgelöster Grund 3

Der Grund, warum ein Arbeitselement gelöst wurde. Zum Beispiel ist die User Story Code Complete, oder der Fehler wurde behoben. Dieses Feld ist schreibgeschützt und nur für Agile- und CMMI-Arbeitsaufgabentypen gültig.

Verweisname=Microsoft.VSTS.Common.ResolvedReason
Datentyp=Zeichenfolge

Alle (Agile, CMMI)

Geprüft von

Der Name des Teammitglieds, das auf eine Codeüberprüfungsanforderung geantwortet hat und in der Antwort zur Codeüberprüfung katalogisiert wird.

Verweisname=Microsoft.VSTS.Common.ReviewedBy
Datentyp=String (Identität)

Codeüberprüfungsantwort

State

Status 3, 4

Der aktuelle Zustand des Arbeitselements. In diesem Feld können Sie den Status einer Arbeitsaufgabe aktualisieren, wenn sie von einem neuen zu einem aktiven oder zu einem abgeschlossenen Zustand wechselt.

Informationen zum Ändern der Workflowzustände finden Sie unter Anpassen des Workflows für einen Prozess.

Informationen zum Ändern der Workflowzustände finden Sie in den folgenden Artikeln:

Informationen zum Ändern der Workflowzustände finden Sie unter Ändern des Workflows für einen Arbeitselementtyp.

Verweisname=System.State
Data type=String

All

Statusänderungsdatum

Das Datum und die Uhrzeit, zu der das Zustandsfeld geändert wurde.

Verweisname=Microsoft.VSTS.Common.StateChangeDate
Data type=DateTime

All

Hinweis

  1. Weitere Informationen finden Sie unter Datums- und Identitätsfelder.
  2. Standardmäßig synchronisiert der Server systemdefinierte Felder für Personennamen oder identitätsbasierte Felder mit Active Directory oder Azure Active Directory. Zu diesen Feldern gehören: Aktiviert von, Zugewiesen zu, Geschlossen von, Erstellt vonund Aufgelöst von. Sie können zugriff auf ein Projekt gewähren, indem Sie Sicherheitsgruppen hinzufügen, die Sie in AD oder Azure AD erstellt haben, oder indem Sie Konten vorhandenen oder benutzerdefinierten Gruppen hinzufügen, die über die Seite Sicherheit der Sammlungseinstellung definiert wurden. Weitere Informationen finden Sie unter Einrichten von Active Directory oder Azure Active Directory.
  3. Weitere Informationen finden Sie in den Feldern Aktiviert nach/Datum und Aufgelöst nach/Datum.
  4. Die Anforderungskategoriegilt für alle Arbeitselementtypen, die im Produktrückstand und Kanban-Board angezeigt werden, und kann diejenigen enthalten, die der Fehlerkategorie basierend auf der Teameinstellung für Fehler auf Boards und Backlogs anzeigen hinzugefügt wurden. Weitere Informationen zu Arbeitselementtypkategorien finden Sie unter Verwenden von Kategorien zum Gruppen von Arbeitselementtypen.

Hinweis

Auch wenn Sie einem Arbeitselementformular ein boardbezogenes Feld wie BoardSpalte oder Board Lane hinzufügen, können Sie das Feld nicht über das Formular ändern.

  1. Weitere Informationen finden Sie unter Datums- und Identitätsfelder.

  2. Standardmäßig synchronisiert der Server systemdefinierte Felder für Personennamen oder identitätsbasierte Felder mit Active Directory oder Azure Active Directory. Zu diesen Feldern zählen: "Aktiviert von", "Zugewiesen zu", "Geschlossen von" und "Behoben von". Sie können zugriff auf ein Projekt gewähren, indem Sie Sicherheitsgruppen hinzufügen, die Sie in AD oder Azure AD erstellt haben, oder indem Sie Konten vorhandenen oder benutzerdefinierten Gruppen hinzufügen, die über die Seite Sicherheit der Sammlungseinstellung definiert wurden. Weitere Informationen finden Sie unter Einrichten von Active Directory oder Azure Active Directory.

    Bei lokalen Bereitstellungen können Sie die Synchronisierung für ein Personennamenfeld mithilfe des Befehlszeilentools witadmin changefields aktivieren oder deaktivieren. Sie können auch benutzerdefinierte Personennamenfelder synchronisieren, indem Sie das Syncnamechanges-Attribut angeben. Weitere Informationen finden Sie unter Verwalten von Arbeitselementfeldern und FIELD(Definition)-Elementverweis.

  3. Berichtbares Feld, bei dem das Attribut auf Dimension festgelegt ist. Nur gültig, wenn die Auflistung für die Unterstützung des lokalen XML-Modells konfiguriert ist. Berichtbare Daten werden in das Data Warehouse exportiert und können in berichte Excel oder SQL Server werden. Verwenden Sie für lokale Azure DevOps den Befehl witadmin changefield, um das berichtbare Attribut für ein Feld zu ändern.

  4. Indiziertes Feld. Das Aktivieren der Indizierung für ein Feld kann die Leistung beim Suchen von Arbeitselementen erhöhen, deren Abfragen dieses Feld angeben. Verwenden Sie für lokale Azure DevOps den Befehl witadmin indexfield, um das Indexattribut für ein Feld zu ändern.

  5. Die Anforderungskategorie gilt für alle Arbeitselementtypen, die im Produktrückstand und im Kanban-Board angezeigt werden. Die Kategorie enthält die Elemente, die der Fehlerkategorie basierend auf der Teameinstellung für Fehler auf Boards und Backlogs anzeigen hinzugefügt wurden. Weitere Informationen zu Arbeitselementtypkategorien finden Sie unter Verwenden von Kategorien zum Gruppen von Arbeitselementtypen.

Hinweis

Auch wenn Sie einem Arbeitselementformular ein boardbezogenes Feld wie BoardSpalte oder Board Lane hinzufügen, können Sie das Feld nicht über das Formular ändern.

  1. Standardmäßig synchronisiert der Server systemdefinierte Felder für Personennamen mit Active Directory oder Azure Active Directory, wenn diese Komponenten konfiguriert sind. Zu diesen Feldern zählen: "Aktiviert von", "Zugewiesen zu", "Geschlossen von" und "Behoben von". Sie können zugriff auf ein Projekt gewähren, indem Sie Sicherheitsgruppen hinzufügen, die Sie in AD oder Azure AD erstellt haben, oder indem Sie Konten vorhandenen oder benutzerdefinierten Gruppen hinzufügen, die über die Seite Sicherheit der Sammlungseinstellung definiert wurden. Weitere Informationen finden Sie unter Einrichten von Active Directory oder Azure Active Directory.

    Sie können die Synchronisierung für ein Personennamenfeld mithilfe des Befehlszeilentools witadmin changefields aktivieren oder deaktivieren. Sie können auch benutzerdefinierte Personennamenfelder synchronisieren, indem Sie das Syncnamechanges-Attribut angeben. Weitere Informationen finden Sie unter Verwalten von Arbeitselementfeldern und FIELD(Definition)-Elementverweis.

  2. Berichtbares Feld, bei dem das Attribut auf Dimension festgelegt ist. Berichtbare Daten werden in das Data Warehouse exportiert und können in berichte Excel oder SQL Server werden. Verwenden Sie für einen lokalen Server den Befehl witadmin changefield, um das berichtbare Attribut für ein Feld zu ändern.

  3. Indiziertes Feld. Das Aktivieren der Indizierung für ein Feld kann die Leistung beim Suchen von Arbeitselementen erhöhen, deren Abfragen dieses Feld angeben. Verwenden Sie für einen lokalen Server den Befehl witadmin indexfield, um das Indexattribut für ein Feld zu ändern.

Personenauswahl

Das Zugewiesen zu feld wird von der Personenauswahlfunktion unterstützt. Wenn Sie z. B. das Zugewiesen zu in einem Arbeitselementformular auswählen, wird die Personenauswahl aktiviert. Wie in der folgenden Abbildung gezeigt, beginnen Sie einfach mit der Eingabe des Namens des Benutzers, den Sie auswählen möchten, und suchen, bis Sie eine Übereinstimmung gefunden haben. Benutzer, die Sie zuvor ausgewählt haben, werden automatisch in der Liste angezeigt. Um Benutzer auszuwählen, die Sie zuvor nicht ausgewählt haben, geben Sie ihren gesamten Namen ein, oder suchen Sie nach dem vollständigen Verzeichnis.

Screenshot of people picker

Für Organisationen, die ihre Benutzer und Gruppen mithilfe von Azure Active Directory (Azure AD) oder Active Directory verwalten, bieten Personenauswahlen Unterstützung für die Suche nach allen Benutzern und Gruppen, die dem AD hinzugefügt wurden, nicht nur für die Benutzer und Gruppen, die dem Projekt hinzugefügt wurden.

Um den Bereich der identitäten, die für die Auswahl verfügbar sind, auf die Benutzer zu beschränken, die dem Projekt hinzugefügt wurden, können Sie dies mithilfe der Gruppe Project-Scoped Users (Benutzer im Gültigkeitsbereich) tun. Weitere Informationen finden Sie unter Einschränken der Identitätssuche und -auswahl.

Datums- und Identitätsfelder

Mehrere Datums- und Identitätsfelder werden basierend auf Workflowzuständen oder Übergängen festgelegt. Einige Felder wie Created By undCreated Datewerden vom System festgelegt, wenn ein Arbeitselement hinzugefügt wird. Andere Felder wie Closed Date und Closed Bywerden über die Workflowdefinition des Arbeitselementtyps festgelegt. Darüber hinaus können für benutzerdefinierte Arbeitselementtypen andere Regeln definiert sein, die die Zuweisungen von Datums- und Identitätsfelden beeinflussen.

Statusänderungen

Das folgende XML-Syntaxbeispiel veranschaulicht Regeln, die für einen Arbeitselementtyp definiert werden können, der die Werte für ausgewählte Felder steuert. Hier werden die Felder Resolved Date, Resolved By, Closed Date, Closed By, Activated Date und ActivatedBy auf festgelegt, wenn ein State-Wert auf New festgelegt ist. Die Statuswertzuweisungen werden zuerst ausgewertet, und dann werden die Übergangszuweisungen als Nächstes ausgewertet.

   <WORKFLOW>
      <STATES>
        <STATE value="New">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Active">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Resolved">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Closed" />
      </STATES>

Zuweisungen für den Übergang von aktivierten und aktivierten Datumsübergängen

Wenn die folgenden Übergänge für ein Bug-Arbeitselement auftreten, werden die folgenden Zuweisungen zu den Feldern Activated By (Aktiviert nach) und Activated Date (Aktiviert nach und Aktiviertes Datum) vorgenommen:

<TRANSITION from="" to="New">
<TRANSITION from="New" to="Active">
<TRANSITION from="New" to="Resolved">
<TRANSITION from="New" to="Closed">
<TRANSITION from="Resolved" to="Active">
<TRANSITION from="Closed" to="Active">
<FIELDS>
   <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
       <COPY from="currentuser" />
           <VALIDUSER />
           <REQUIRED />
    </FIELD>
    <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <SERVERDEFAULT from="clock" />
   </FIELD>
</FIELDS>

Und wenn die folgenden Übergänge für das Arbeitselement Fehler auftreten:

<TRANSITION from="Active" to="New">
<TRANSITION from="Active" to="Closed">
<TRANSITION from="Resolved" to="Closed">

Anschließend werden die Felder Activated By (Aktiviert von) und Activated Date (Aktiviert nach) auf READONLY festgelegt.

<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
   <READONLY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
   <READONLY />
</FIELD>

Felder "Aktiviert nach/Datum" und "Aufgelöst nach/Datum"

Das System aktualisiert diese Felder Aktiviert von , Aktiviertes Datum , Aufgelöst von und Aufgelöstes Datum, wenn eine Änderung basierend auf den entsprechenden —— Workflowkategoriezuständen auftritt. Wenn sich der Workflowstatus in die Kategorie Vorgeschlagener Status ändert, werden Aktiviert nach und Aktiviertes Datum aktualisiert. Wenn sich der Workflowzustand in die Statuskategorie Aufgelöst ändert, werden Die Statuskategorien Aufgelöst nach und Aufgelöstes Datum aktualisiert.

Weitere Informationen zur Zuordnung von Workflowzuständen zu Zustandskategorien finden Sie unter Verwenden von Workflowzuständen und Zustandskategorien in Backlogs und Boards.

Hinweis

Die Logik für die hier beschriebenen Felder gilt für Azure DevOps Services, Azure DevOps Server Update 2020.1und spätere Versionen.

Da diese Felder auf die Workflowzustandskategorien verweisen, wird beim Aktualisieren der Felder auf benutzerdefinierte Workflowzustände verwiesen, die Sie hinzufügen. Weitere Informationen zur Anpassung finden Sie unter Anpassen des Workflows für einen Prozess.

Weitere Hinweise:

  • Die Felder werden immer dann aktualisiert, wenn ein Arbeitselement aus einem anderen Kategoriezustand als dem festgelegten wechselt. Wenn Sie beispielsweise ein Arbeitselement von Neu in Fest aktualisieren,werden die Felder Aufgelöst nach/Aufgelöstes Datum aktualisiert. Wenn Sie jedoch ein Update von Fixed und Ready for Testingdurchführen, die sich im gleichen Kategoriezustand befinden, werden die Felder "Resolved By/Resolved Date" nicht aktualisiert.
  • Wenn Sie zurückwechseln, z. B. von einem Aufgelöst-Zustand in einen aktiven Zustand, werden die Werte für die Felder Aufgelöst nach/Aufgelöstes Datum vom System entfernt. Wenn Sie von Aktiv aufNeu umgeschaltet haben,werden die Werte für die Felder Activated By/Activated Date (Aktiviert nach/Aktiviertes Datum) vom System entfernt.
  • Ändern Sie die Werte für diese Felder nicht manuell. Dabei handelt es sich um Systemfelder, die durch Systemregeln bestimmt werden. Jeder Wert, den Sie festlegen möchten, wird übergeschrieben.

REST-API

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie in einer der folgenden REST-API-Ressourcen:

SDK-Ressourcen

Informationen zur programmgesteuerten Interaktion mit Abfragen finden Sie unter Abfragen nach Fehlern, Aufgaben und anderen Arbeitselementen.

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

Die Zustände im Workflow unterstützen die Nachverfolgung des Arbeitsstatus, wenn er von einem neuen Zustand in einen geschlossenen oder abgeschlossenen Zustand wechselt. Kanban-Abfragefelder unterstützen die Nachverfolgung des Arbeitsstatus beim Wechsel von einer Spalte oder einem Verantwortlichkeitsfeld zu einer anderen im Kanban-Board.

Jeder Workflow besteht aus einer Reihe von Zuständen, gültigen Übergängen zwischen Zuständen und Gründen für den Übergang des Arbeitselements in den ausgewählten Zustand. Workflowzustände und Gründe unterscheiden sich zwischen den Arbeitselementtypen (WITs) und den Standardprozessen, die zum Erstellen Ihres Projekts verwendet werden.

Die meisten Arbeitselemente werden vom Zustand Neu, Aktiv oder Vorgeschlagen zum Zustand Fertig oder Geschlossen verschoben. Beim Statuswechsel der einzelnen Arbeitsaufgabe können diese auch verschiedenen Mitgliedern des Teams neu zugewiesen werden. Beispielsweise kann ein Tester einen Fehler erstellen, der während der Selektierung einem anderen Teammitglied zugewiesen wird. Wenn das andere Teammitglied den Fehler behebt, wird er dem Tester neu zugewiesen, der ihn erstellt hat.

Beispielsweise können Sie alle Arbeitselemente finden, die geschlossen, aber dann erneut aktiviert wurden. Wenn Sie das Feld Änderungsdatum angeben, können Sie sich auf Reaktivierungen konzentrieren, die heute, gestern oder in der letzten Woche stattgefunden haben.

Query Editor filter for reactivated items

Sie können auch die Felder Aktiviert von und Aktiviertes Datum oder andere Workflowfelder verwenden.

Tipp

Nicht alle Felder sind für alle WITs gültig. Wechseln Sie zu Workflow- und Kanban-Abfragefelder für den Satz von Feldern, die Sie in Abfragen einschließen können, und zu den WITs, für die sie gelten.

Wenn Sie noch nicht mit dem Erstellen von Abfragen sind, finden Sie weitere Informationen unter Verwenden des Abfrage-Editors zum Auflisten und Verwalten von Abfragen.

Unterstützte Operatoren und Makros

Abfrageklauseln, die ein Identity- oder workflow-zugeordnetes Feld angeben, können die in der folgenden Tabelle aufgeführten Operatoren und Makros verwenden. Weitere Informationen zum Felddatentyp finden Sie unter Workflow- und Kanban-Boardfelder weiter unten in diesem Artikel.