Anzeigen, Ausführen oder Senden einer Arbeitselementabfrage

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

Visual Studio 2019-| Visual Studio 2022

Um Arbeitselemente zu finden, die Ihnen oder Ihrem Team zugewiesen sind, führen Sie eine Abfrage aus. Viele Arbeitsaufgabenabfragen sind mit Ihrem Prozess vordefinierter. Mitglieder Ihres Teams haben möglicherweise freigegebene Abfragen erstellt, die Sie anzeigen und ausführen können. Häufig ist es einfacher, eine neue Abfrage zu definieren, indem Sie auf der Abfragedefinition aufbauen, die ihnen bereits zur Verfügung steht.

Voraussetzungen

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können die berechtigungen ändern, die für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage festgelegt sind. Ausführliche Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter freigegebenen Abfragen hinzuzufügen und zu speichern, müssen Sie dem Einfachen Zugriff oder höher gewährt werden. Außerdem müssen Sie ihre Berechtigung "Mitwirken " auf "Zulassen" für den Ordner festlegen, dem Sie die Abfrage hinzufügen möchten. Standardmäßig verfügt die Gruppe "Mitwirkende " nicht über diese Berechtigung.

Hinweis

Benutzer mit Stakeholderzugriff für ein öffentliches Projekt haben vollständigen Zugriff auf Abfragefeatures wie Benutzer mit standardem Zugriff. Ausführliche Informationen finden Sie unter "Stakeholder access quick reference".

  • Standardmäßig können alle Projektmitglieder und Benutzer mit Stakeholderzugriff alle freigegebenen Abfragen anzeigen und ausführen. Sie können die berechtigungen ändern, die für einen freigegebenen Abfrageordner oder eine freigegebene Abfrage festgelegt sind. Ausführliche Informationen finden Sie unter Festlegen von Abfrageberechtigungen.
  • Um eine Abfrage unter freigegebenen Abfragen hinzuzufügen und zu speichern, müssen Sie dem Einfachen Zugriff oder höher gewährt werden. Außerdem müssen Sie ihre Berechtigung "Mitwirken " auf "Zulassen" für den Ordner festlegen, dem Sie die Abfrage hinzufügen möchten. Standardmäßig verfügt die Gruppe "Mitwirkende " nicht über diese Berechtigung.

Öffnen von Abfragen

Überprüfen Sie im Webbrowser (1), ob Sie das richtige Projekt ausgewählt haben, (2) Die Tafelabfragen> und dann (3) "Alle".

Open Boards-Abfragen>, vertikale Navigation

Wenn Sie Abfragen zum ersten Mal öffnen, wird die Seite für Favoriten geöffnet. Auf dieser Seite sind diese Abfragen aufgeführt, die Sie angegeben haben, ein Favorit. Andernfalls können Sie " Alle " auswählen, um alle Abfragen anzuzeigen, die Sie für das Projekt definiert und freigegeben haben.

Tipp

Abfragen, die Sie oder Ihr Team als Favoriten ausgewählt haben, werden auf der Seite " Favoriten " angezeigt. Favoritenabfragen zusammen mit anderen Objekten werden auch auf Ihrer Project-Seite angezeigt. Weitere Informationen finden Sie unter Festlegen von persönlichen oder Teamfavoriten.

Öffnen Sie im Webbrowser Boards-Abfragen>.

Öffnen Von Ihrem Webbrowser aus öffnen Sie Boards-Abfragen>

Ausführen einer Abfrage in Azure Boards

Um eine beliebige Abfrage auszuführen, erweitern Sie einen Ordner, und wählen Sie den Titel der Abfrage aus. Die Ansicht wird geöffnet, um die Abfrageergebnisse anzuzeigen.

Sie können eine Abfrage auch mithilfe der Befehlszeilenschnittstelle von Azure DevOps ausführen.

Tipp

Die Seite "Abfragen " wie bei anderen Webportalseiten erinnert sich an die ansicht, zu der Sie zuletzt navigiert haben, und gibt Sie zu dieser Ansicht zurück.

  1. Wählen Sie "Alle " aus, um die Seite zu öffnen, auf der Sie alle Abfragen anzeigen können, die Sie definiert haben oder die innerhalb Ihres Projekts freigegeben werden.

    Webportal, Auswählen von Boards>Abfragen>Alle Seite

  2. Wählen Sie "Meine Abfragen " nach Bedarf aus.

    • Um alle Ihnen zugewiesenen Arbeitselemente anzuzeigen, wählen Sie "Zugewiesen" aus. Diese Abfrage verwendet das @Me-Makro , um alle Ihnen zugewiesenen Arbeitselemente auflisten zu können.
    • Um alle Arbeitsaufgaben anzuzeigen, die Sie folgen, wählen Sie "Gefolgte Arbeitselemente" aus. Diese Abfrage verwendet das @Follows-Makro (ID in @Follows) der Liste aller Arbeitselemente, denen Sie folgen möchten. Weitere Informationen finden Sie unter "Folgen einer Arbeitsaufgabe oder einer Pullanforderung".
  3. Wählen Sie "Freigegebene Abfragen " aus, um den Ordner zu erweitern und auf Abfragen zuzugreifen, die als freigegebene Abfragen gespeichert sind.

  4. Wählen Sie einen Ordner in einem Breadcrumb aus, um einen Abfrageordner zu öffnen.

    Screenshot des Beispiels

Ausführen einer Abfrage aus der Befehlszeile

Sie können eine Abfrage in der CLI mit dem Az Boards-Abfragebefehl ausführen. Informationen zu den ersten Schritten finden Sie unter Get started with Azure DevOps CLI.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

Parameter

  • id: Die ID einer vorhandenen Abfrage. Erforderlich, es sei denn, pfad oder-wiql wird angegeben.
  • wiql: Die Abfrage im Format "Arbeitselementabfragesprache". Wird ignoriert, wenn-id oder-pfad angegeben ist.
  • pfad: Der Pfad einer vorhandenen Abfrage. Wird ignoriert, wenn-id angegeben ist.
  • org: Azure DevOps-Organisations-URL. Sie können die Standardorganisation mithilfe az devops configure -d organization=ORG_URLvon . Erforderlich, wenn sie nicht als Standard konfiguriert oder mit git configder Verwendung aufgenommen wurde. Beispiel: --org https://dev.azure.com/MyOrganizationName/.
  • Projekt: Name oder ID des Projekts. Sie können das Standardprojekt mithilfe von az devops configure -d project=NAME_OR_ID. Erforderlich, wenn sie nicht als Standard konfiguriert oder mit git configder Verwendung aufgenommen wurde.

Beispiel

Der folgende Befehl führt eine Abfrage mit der angegebenen ID aus und zeigt das Ergebnis im Tabellenformat an.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

Der folgende Befehl führt eine Abfrage mit dem angegebenen WIQL aus und zeigt das Ergebnis im Tabellenformat an.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Abfrageverzeichnis, Abfrageordner und Breadcrumbs

Abfrageordner

Hinweis

Sie können keine Ordner zu "Meine Favoriten " oder " Teamfavoriten" hinzufügen.

Die Seite "Abfragen " enthält eine verzeichnisorientierte Ansicht, die Sie filtern können, um bestimmte Abfragen von Interesse zu finden. Wenn Sie in den Abfragenseiten arbeiten, können Sie zu einem Unterordner, Ordner oder einer Seite navigieren.

Abfragen von Breadcrumbs

Sie können auch eine Abfrage auswählen, die Sie im Auswahlmenü ausgewählt haben, oder Sie können auswählen, dass sie alle Abfragen durchsuchen, die Sie zur Seite "Alle Abfragen " zurückgibt.

Screenshot von Abfragen, Abfrageauswahl.

Auf der Seite "Abfragen " wird die Ordnerstruktur im linken Bereich angezeigt. Sie können Ordner erweitern und reduzieren, Ordner umbenennen und Abfragen von einem Ordner in einen anderen ziehen und ablegen. Weitere Informationen finden Sie unter Verwalten und Organisieren von Abfragen.

Screenshot der Seite

Weitere Informationen finden Sie unter "Fragen zur Abfrage", "Navigieren" und "Ordner".

Alle und Favoriten unterstützte Aufgaben

Sie können die meisten Aufgaben zum Anzeigen und Ausführen von Abfragen aus den einzelnen Abfragelistenseiten ausführen, wie in der folgenden Tabelle angegeben. Nur Abfragen, die Sie unter "Meine Abfragen " speichern und unter "Meine Favoriten" favoriten angezeigt haben. Nur Abfragen, die unter freigegebenen Abfragen gespeichert sind, können von einem Team bevorzugt werden.


Aufgabe
Favoriten
(Browser)
All
(Browser)
Arbeitselemente
(Team-Explorer)
Alle bevorzugten Abfragen, Ihre oder ein Team anzeigen, zu dem Sie gehören ✔️ ✔️
Alle Ihre Abfragen oder freigegebenen Abfragen für das aktuelle Projekt anzeigen ✔️ ✔️
Ausführen einer Abfrage, Öffnen des Kontextmenüs für eine Abfrage ✔️ ✔️ ✔️
Erweitern oder Reduzieren von Containerordnern oder Abfrageordnern ✔️ ✔️ ✔️
Filtern der Liste der Abfragen ✔️ ✔️
Favoriten einer Abfrage (für Webportal, Favoriten auswählen) ✔️
Aufheben der Voreinstellung einer Abfrage (für Webportal, Auswählen ) ✔️ ✔️ ✔️
Hinzufügen einer neuen Abfrage: Auswählen ✔️ ✔️ ✔️

Filtern der Liste der Abfragen

Geben Sie ein Schlüsselwort in das Filterfeld ein, um den Satz von Abfragen zu filtern, die entweder auf den Seiten "Favoriten " oder "Alle " angezeigt werden. Weitere Informationen zum Filtern finden Sie unter "Filterbacklogs", "Boards", "Abfragen" und "Pläne".

Screenshot aller Abfragen im Projekt, das nach WIT IQ-Schlüsselwortkriterien gefiltert wird.

Weitere Informationen finden Sie unter "Fragen zur Abfrage", "Navigieren" und "Ordner".

Email Abfrageelemente oder Freigeben einer Abfrage-URL

In der Abfrage-Editor- oder Ergebnisansicht können Sie eine formatierte Liste von Abfrageelementen per E-Mail senden oder die Abfrage-URL kopieren.

Wählen Sie das Symbol "Aktionen" aus, um das Menü zu öffnen, und wählen Sie aus den aufgelisteten Optionen Email Abfrage- oder Abfrage-URL kopieren aus.

Webportal, Abfrage-Editor/Ergebnisse, Menü
Sie können die E-Mail nur an eine einzelne Adresse für ein Projektmitglied senden, das vom System erkannt wird. Das Hinzufügen einer Teamgruppe oder Sicherheitsgruppe zur Zeile wird nicht unterstützt. Wenn Sie ein E-Mail-Konto hinzufügen, das das System nicht erkennt, erhalten Sie eine Nachricht, dass mindestens ein Empfänger Ihrer E-Mail keine Berechtigungen zum Lesen der gesendeten Arbeitselemente hat.

Hinweis

Wenn Sie eine formatierte Liste an Personen senden möchten, die keine Projektmitglieder sind, müssen Sie die option "Kopieren als HTML" verwenden, die in der Liste der Arbeitselemente kopieren beschrieben wird. Für lokale Azure DevOps müssen alle E-Mail-Aktionen einen SMTP-Server konfigurieren. Wenn Sie keinen SMTP-Server konfiguriert haben, können Sie dies umgehen, indem Sie "Kopieren als HTML" verwenden.

Wählen Sie "Abfrage-URL kopieren" aus. Informationen zu E-Mail-Abfrageelementen finden Sie unter Kopieren einer Liste von Arbeitselementen.

Webportal, Abfrage-Editor/Ergebnisse, Abfrage-URL kopieren

Hinweis

Mit Email Abfrage sendet das System die formatierte Liste an diejenigen Teamkollegen, die Sie auswählen. Wenn Sie eine formatierte Liste an Personen senden möchten, die nicht Teil des Projekts sind, müssen Sie die option "Kopieren als HTML" verwenden, die in der Liste der Arbeitsaufgaben beschrieben ist. Für alle E-Mail-Aktionen muss ein SMTP-Server konfiguriert werden. Wenn Sie keinen SMTP-Server konfiguriert haben, können Sie dies umgehen, indem Sie "Kopieren als HTML" verwenden.

Versuchen Sie dies als Nächstes: