Anzeigen, Ausführen oder Senden einer Arbeitselementabfrage

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

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) Boards> Queries und dann (3) "Alle".

Open Boards>Queries, vertical nav

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 in Ihrem Webbrowser Boards> Queries.

From your web browser, open Boards>Queries

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

    Web portal, choose Boards>Queries>All page

  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 of queries breadcrumb example.

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 Erste Schritte mit 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 verzeichnisbezogene 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.

Queries breadcrumbs

Außerdem können Sie eine Abfrage auswählen, die Sie im Auswahlmenü ausgewählt haben, Oder Sie können alle Abfragen durchsuchen, die Sie zur Seite "Alle Abfragen " zurückgibt.

Screenshot of Queries, Query selector.

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 of Queries page, TFS 2018 and earlier versions.

Weitere Informationen finden Sie unter Abfrage-FAQs, Navigieren und Ordner.

Alle und Favoriten unterstützte Aufgaben

Sie können die meisten Aufgaben zum Anzeigen und Ausführen von Abfragen aus jedem der 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 wurden, können von einem Team favorisieren.


Aufgabe
Favoriten
(Browser)
All
(Browser)
Arbeitselemente
(Team-Explorer)
Alle Favoritenabfragen, Ihre oder ein Team anzeigen, zu dem Sie gehören ✔️ ✔️
Anzeigen aller Abfragen oder freigegebenen Abfragen für das aktuelle Projekt ✔️ ✔️
Ausführen einer Abfrage, öffnen Sie das Kontextmenü für eine Abfrage ✔️ ✔️ ✔️
Erweitern oder Reduzieren von Containerordnern oder Abfrageordnern ✔️ ✔️ ✔️
Filtern der Liste der Abfragen ✔️ ✔️
Favoriten einer Abfrage (für webportal, auswählen Favorite) ✔️
Aufheben 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 Favoriten oder allen Seiten angezeigt werden. Weitere Informationen zum Filtern finden Sie unter Filter-Backlogs, Boards, Abfragen und Pläne.

Screenshot showing all queries in the project filtered by WIT IQ keyword criteria.

Weitere Informationen finden Sie unter Abfrage-FAQs, Navigieren und Ordner.

E-Mail-Abfrageelemente oder Freigeben einer Abfrage-URL

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

Wählen Sie das Symbol "Aktionen" aus, um das Menü zu öffnen, und wählen Sie aus den aufgeführten Optionen, der E-Mail-Abfrage oder der URL der Abfrage kopieren aus.

Web portal, Query Editor/Results, Open Actions menu, Choose Email query or Copy query URL
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 nicht über Berechtigungen zum Lesen der E-Mail-Elemente verfügt.

Hinweis

Um eine formatierte Liste an Personen zu senden, die keine Projektmitglieder sind, müssen Sie die option "Kopieren als HTML" verwenden, die in einer Liste der Arbeitselemente beschrieben ist. Für lokale Azure DevOps benötigen alle E-Mail-Aktionen einen SMTP-Server, der konfiguriert werden soll. 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.

Web portal, Query Editor/Results, Copy query URL

Hinweis

Mit der E-Mail-Abfrage sendet das System die formatierte Liste an diese Teamkollegen, die Sie auswählen. Um eine formatierte Liste an Personen zu senden, die nicht Teil des Projekts sind, müssen Sie die option "Kopieren als HTML" verwenden, die in der Liste der Arbeitselemente beschrieben ist. Alle E-Mail-Aktionen benötigen einen SMTP-Server, der konfiguriert werden soll. Wenn Sie keinen SMTP-Server konfiguriert haben, können Sie dies umgehen, indem Sie "Kopieren als HTML" verwenden.

Versuchen Sie dies als Nächstes: