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".
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>.
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.
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.
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".
Wählen Sie "Freigegebene Abfragen " aus, um den Ordner zu erweitern und auf Abfragen zuzugreifen, die als freigegebene Abfragen gespeichert sind.
Wählen Sie einen Ordner in einem Breadcrumb aus, um einen Abfrageordner zu öffnen.
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_URL
von . Erforderlich, wenn sie nicht als Standard konfiguriert oder mitgit config
der 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 mitgit config
der 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.
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.
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.
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, ![]() |
✔️ | ||
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".
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.
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.
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.