Abfragen nach Zuweisung oder Workflowänderungen in Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

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, wenn sie von einer Spalte oder einem Swimlane auf dem Kanban-Board zu einer anderen wechselt.

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 und Standardprozessen, die zum Erstellen Ihres Projekts verwendet werden.

Die meisten Arbeitselemente wechseln aus dem Status Neu, Aktiv oder Vorgeschlagen in den Zustand Fertig oder Geschlossen . 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 zugewiesen, der ihn erstellt hat.

Sie können beispielsweise alle Arbeitselemente finden, die geschlossen, dann aber wieder aktiviert wurden. Durch Angeben des Felds Geändertes Datum können Sie sich auf Reaktivierungen konzentrieren, die heute, gestern oder in der letzten Woche aufgetreten sind.

Abfrage-Editor Filter für reaktivierte Elemente.

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

Tipp

Nicht alle Felder sind für alle Arbeitselementtypen gültig. Wechseln Sie zu Workflow- und Kanban-Abfragefeldern für die Felder, die Sie in Abfragen einschließen können, und für welche Arbeitselementtypen sie gelten.

Wenn Sie noch nicht mit dem Erstellen von Abfragen arbeiten, lesen Sie Verwenden des Abfrage-Editors zum Auflisten und Verwalten von Abfragen.

Unterstützte Operatoren und Makros

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


Datentyp

Unterstützte Operatoren und Makros


BoolescherWert 1

= , <> , =[Field] , <>[Field]


DateTime

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Makros: @Today, @Today +/- n gültig für ein beliebiges DateTime-Feld


Identität

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


Einzelner Text (Zeichenfolge)2

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


Verwenden Sie die In Operatoren und Not In , um zwei oder mehr Auswahllisteneinträge oder einen durch Trennzeichen getrennten Satz von Elementen zu filtern oder auszuschließen. Verwenden Sie die In Group Operatoren oder Not In Group , um nach Elementen zu filtern, die zu einer Kategoriegruppe oder Sicherheitsgruppe gehören oder nicht. Weitere Informationen finden Sie unter Abfragefelder, Operatoren und Makros.

Datums- und Uhrzeitmuster

Das Datums- und Uhrzeitmuster, das Sie für DateTime-Felder eingeben, sollte mit dem übereinstimmen, das Sie in Ihrem Profil auswählen. Informationen zum Anzeigen oder Ändern Ihrer Auswahl finden Sie unter Festlegen von Benutzereinstellungen, Uhrzeit und Gebietsschema.

Seite

Seite

Identitätsbasierte Abfragen

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

Verwenden Sie = , um aktuelle Zuweisungen zu suchen, Was Ever um Elemente basierend auf früheren Zuweisungen aufzulisten und @Me den Bereich auf Ihre Benutzeridentität zu richten.

Filtern nach

Einschließen dieser Abfrageklauseln


Mir zugewiesene aktive Elemente

Assigned To @Me
And State = Active

Geschlossene Elemente, die mir irgendwann zugewiesen wurden

Assigned To Was Ever @Me
And State = Closed

Aktive User Storys, die dem Webteam 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 ( wertlos lassen )

Assigned To = _


Abfragen zur 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 .

Screenshot: Abfrage-Editor, Filter basierend auf der Zuweisung zu einer Sicherheitsgruppe.

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 sind oder keine Mitglieder einer Gruppe sind. Beispiele für Gruppen, die Sie angeben können, umfassen 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 Geschichten

Work Item Type = User Story
And State = Resolved

Neue oder aktive Geschichten, Fehler und Aufgaben

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

Entfernte Elemente, da sie dupliziert sind

State= Removed
And Reason = Duplicate

Elemente, bei denen Akzeptanztests fehlschlagen

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, z. B. "Erstellt von", "Geändert von", "Aufgelöst von" 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

Zum Auflisten von Arbeitselementen, deren Zustand innerhalb eines bestimmten Datumsbereichs geändert wurde, können Sie das Feld Zustandsänderungsdatum verwenden, um die Suche einzugrenzen und dann Klauseln für Änderungen an dem Feld Status hinzuzufügen. In der folgenden Abbildung ist ein Beispiel angegeben.

Screenshot: Abfrage-Editor, filtert die Felder Zustandsänderungsdatum und Zustand.

Abfragen von Änderungen an einem Kanban-Board

Mithilfe der Kanban-Abfragefelder – Board column, 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.

Sie können Elemente basierend auf dem Teambereichspfad auflisten, und wenn sie sich in einer bestimmten benutzerdefinierten Kanban-Spalte und einer bestimmten Swimlane befinden. Wenn Sie eine Spalte oder eine Schwimmlane umbenennen, müssen Sie die Abfragefilter so aktualisieren, dass sie den neuen Namen widerspiegeln. Weitere Ideen finden Sie in diesem Blogbeitrag: Neue Felder bringen Kanban-Freundlichkeit zu Abfragen, und mehr

Screenshot der Abfrage-Editor, Filtern nach Kanban Board Column und Board Lane Feldern.

Hinweis

Abfragen sind jetzt standardmäßig auf das aktuelle Projekt festgelegt. Überprüfen Sie die Abfrage projektübergreifend , um Arbeitselemente zu finden, die in anderen Projekten innerhalb 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 in der Expedite Swimlane

Board Lane = Expedite

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

Board Lane Contains Test

Elemente, die sich jemals in der Spalte "In Review" befanden

Board Column Was Ever In Review


Wichtig

Arbeitselemente, die auf mehr als dem Kanban-Board eines Teams angezeigt werden, können Zu Ergebnissen führen, die Ihren Erwartungen nicht entsprechen, da jedes Team seine Kanban-Boardspalten und Swimlanes anpassen kann. Die werte, die den Feldern Kanban Board Column, Board Column Done und Board Lane zugewiesen sind, unterscheiden sich möglicherweise von den Erwartungen, wenn ein anderes Team das Arbeitselement aus einem anderen Board aktualisiert. Weitere Informationen finden Sie unter Hinzufügen, Überprüfen und Aktualisieren von 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 fortschreitet. Oder sie werden aktualisiert, wenn Sie ein Arbeitselement im Kanban-Board in eine andere Spalte oder ein anderes Schwimmlane verschieben. Einige dieser Felder werden im Arbeitselementformular nicht 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.

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 fertig war.

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

Fehler, Änderungsanforderung, Epic, Feature, Problem, Produktbacklogelement, Anforderung, Überprüfung, Risiko, Freigegebener Schritt, Aufgabe, Testfall, User Story

Aktiviertes Datum 1, 3

Das Datum und die Uhrzeit der Änderung des Arbeitselements in den Status "In Bearbeitung ".

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

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

All

2 zugewiesen

Zugewiesen 2, 3, 4

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

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

All

Boardspalte

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

Referenzname=System.BoardColumn
Datentyp=Zeichenfolge

Anforderungskategorie 4

Anforderungskategorie 5

Boardspalte fertig

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

Referenzname=System.BoardColumnDone
Datentyp=Boolean

Anforderungskategorie 4

Anforderungskategorie 5

Board Lane

Die aktuelle Kanban-Board-Swimlane-Zuweisung des Arbeitselements, z. B. Default, Expedite, Blocked oder eine andere benutzerdefinierte Swimlane-Zuweisung. Referenzname=System.BoardLane
Datentyp=Zeichenfolge

Anforderungskategorie 4

Anforderungskategorie 5

Geschlossen durch 1, 2

Geschlossen durch 1, 2, 3

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

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

All

Geschlossen am

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

Referenzname=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.

Referenzname=System.CreatedDate
Datentyp=DateTime

All

`Reason`

Grund 3, 4

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

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

Referenzname=System.Reason
Datentyp=Zeichenfolge

Alle (mit Ausnahme von Testfall und freigegebenen Schritten)

Behoben durch 1, 2

Aufgelöst durch 1, 2, 3

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

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

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

All

Gelöst am

Datum 1, 2 behoben

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

Das Datum und die Uhrzeit, an dem das Arbeitselement in den Workflowstatus Aufgelöst oder erledigt verschoben wurde.

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

All

Grund für Lösung

Grund 3 behoben

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.

Referenzname=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 Codeüberprüfungsantwort katalogisiert ist.

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

Codeüberprüfungsantwort

State

Zustand 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
Datentyp=Zeichenfolge

All

Datum der Zustandsänderung

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

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

All

Hinweis

  1. Weitere Informationen finden Sie unter Datums- und Identitätsfelder.
  2. Standardmäßig synchronisiert der Server systemdefinierte Personennamen- oder identitätsbasierte Felder mit Active Directory oder Azure Active Directory. Zu diesen Feldern gehören: Activated By, Assigned To, Closed By, Created By und Resolved By. 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 zu vorhandenen oder benutzerdefinierten Gruppen hinzufügen, die auf der Seite "Sicherheit " für die Sammlungseinstellung definiert sind. Weitere Informationen finden Sie unter Einrichten von Active Directory oder Azure Active Directory.
  3. Weitere Informationen finden Sie unter Aktiviert nach/Datum und Aufgelöst nach/Datum felder.
  4. Die Anforderungskategorie gilt für alle Arbeitselementtypen, die im Produktbacklog 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 werden. Weitere Informationen zu Kategorien von Arbeitselementtypen finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitselementtypen.

Hinweis

Selbst wenn Sie einem Arbeitselementformular ein board-bezogenes Feld hinzufügen, z. B. Board Column oder Board Lane, können Sie das Feld aus dem Formular nicht ändern.

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

  2. Standardmäßig synchronisiert der Server systemdefinierte 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 zu vorhandenen oder benutzerdefinierten Gruppen hinzufügen, die auf der Seite "Sicherheit " für die Sammlungseinstellung definiert sind. 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 Referenz zu FIELD-Elementen (Definition).

  3. Berichtsfähiges 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. Berichtsfähige Daten werden in das Data Warehouse exportiert und können in Excel oder SQL Server-Berichten eingeschlossen werden. Verwenden Sie für lokale Azure DevOps den Befehl witadmin changefield , um das meldebare 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 index-Attribut für ein Feld zu ändern.

  5. Die Anforderungskategorie gilt für alle Arbeitselementtypen, die im Produktbacklog 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 Kategorien von Arbeitselementtypen finden Sie unter Verwenden von Kategorien zum Gruppieren von Arbeitselementtypen.

Hinweis

Selbst wenn Sie einem Arbeitselementformular ein board-bezogenes Feld hinzufügen, z. B. Board Column oder Board Lane, können Sie das Feld aus dem Formular nicht ändern.

Personenauswahl

Das Feld Zugewiesen an wird vom Personenauswahlfeature unterstützt. Wenn Sie beispielsweise in einem Arbeitselementformular das Feld Zugewiesen an 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 Sie, 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 des <span class=@mention-Tools in Der Diskussion mit der Personenauswahl." />

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 die Benutzer und Gruppen, die dem Projekt hinzugefügt wurden.

Um den Bereich der Identitäten, die zur 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 (Projektbezogene Benutzer ) tun. Weitere Informationen finden Sie unter Verwalten Ihrer Organisation, 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, z. B . Erstellungsdatum und Erstellungsdatum, werden vom System festgelegt, wenn ein Arbeitselement hinzugefügt wird. Andere Felder, z. B. Closed Date und Closed By, werden über die Workflowdefinition des Arbeitselementtyps festgelegt. Darüber hinaus können für benutzerdefinierte Arbeitselementtypen andere Regeln definiert sein, die die Datums- und Identitätsfeldzuweisungen beeinflussen.

Datums- und Uhrzeitmuster

Das Datums- und Uhrzeitmuster, das Sie für DateTime-Felder eingeben, sollte mit dem übereinstimmen, das Sie in Ihrem Profil auswählen. Informationen zum Anzeigen oder Ändern Ihrer Auswahl finden Sie unter Festlegen von Benutzereinstellungen, Uhrzeit und Gebietsschema.

Seite

Seite

Statusänderungen

Das folgende XML-Syntaxbeispiel veranschaulicht Regeln, die für einen Arbeitselementtyp definiert werden können, der die Werte für Auswahlfelder steuert. Hier werden die Felder Aufgelöstes Datum, Aufgelöst von, Geschlossen von, Aktiviertes Datum und Aktiviert von auf EMPTY festgelegt, wenn ein Statuswert auf Neu 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 aktivierte und aktivierte Datumsübergänge

Wenn die folgenden Übergänge für ein Fehlerarbeitselement auftreten, werden die folgenden Zuweisungen zu den Feldern Aktiviert von 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">

Dann werden die Felder Aktiviert von und Aktiviertes Datum auf READONLYfestgelegt.

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

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

Das System aktualisiert diese Felder (Aktiviert nach, Aktiviertes Datum, Aufgelöst von und Aufgelöstes Datum), wenn eine Änderung basierend auf den entsprechenden Workflowkategoriezuständen erfolgt. Wenn sich der Workflowzustand in die Statuskategorie "Vorgeschlagen " ändert, werden "Aktiviert von" und "Aktiviertes Datum " aktualisiert. Wenn sich der Workflowzustand in eine Statuskategorie Aufgelöst ändert, werden 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.1 und höhere Versionen.

Da diese Felder auf die Workflowstatuskategorien verweisen, werden beim Aktualisieren der Felder auf die von Ihnen hinzugefügten benutzerdefinierten Workflowzustände verwiesen. Weitere Informationen zur Anpassung finden Sie unter Anpassen des Workflows für einen Prozess.

Weitere Hinweise:

  • Die Felder werden jedes Mal aktualisiert, wenn ein Arbeitselement aus einem anderen Kategoriezustand als dem festgelegten wechselt. Wenn Sie z. B. ein Arbeitselement von "Neu " auf "Behoben" aktualisieren, werden die Felder "Aufgelöst nach/Aufgelöst" aktualisiert. Wenn Sie jedoch von Fixed und Ready for Testing (die sich im gleichen Kategoriestatus befinden) aktualisieren, werden die Felder "Aufgelöst nach/Aufgelöst " nicht aktualisiert.
  • Wenn Sie rückwärts wechseln, z. B. von einem Aufgelösten in den Status Aktiv , löscht das System die Werte für die Felder Aufgelöst nach/Aufgelöstes Datum . Wenn Sie von Aktiv zu Neu gelangt sind, löscht das System die Werte für die Felder Aktiviert nach/Aktiviertes Datum .
  • Ändern Sie die Werte für diese Felder nicht manuell. Es handelt sich um Systemfelder, die durch Systemregeln gesteuert werden. Jeder Wert, den Sie festlegen möchten, wird überschreiben.

REST-API

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