Anzeigen, Ausführen oder Senden einer Arbeitselementabfrage per E-Mail

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Sie können eine Abfrage ausführen, um Arbeitselemente zu suchen, die Ihnen oder Ihrem Team zugewiesen sind. Ihr Prozess kann mehrere vordefinierte Abfragen enthalten, auf die Sie zugreifen und die Sie ausführen können. Häufig ist es einfacher, eine neue Abfrage zu erstellen, indem eine vorhandene Abfragedefinition geändert wird.

Hinweis

Die in diesem Artikel verwendeten Browserbilder stammen aus dem Feature „Neue Boards-Hubs“, das standardmäßig aktiviert ist. Wenn dieses Feature nicht aktiviert ist, verwenden Sie möglicherweise die vorherige Umgebung für Boards. Um die Bilder für die vorherige Umgebung anzuzeigen, wählen Sie die Azure DevOps Server 2022-Version dieses Artikels aus.

Voraussetzungen

• Zugriffsebenen:
  • Um freigegebene Abfragen anzuzeigen und auszuführen, müssen Sie Ein Projektmitglied sein.
  • Um eine freigegebene Abfrage hinzuzufügen und zu speichern, verfügen Sie über mindestens einfachen Zugriff.
• Berechtigungen: Für Sie muss die Berechtigung Mitwirken für den Ordner, dem Sie die Abfrage hinzufügen möchten, auf Zulassen festgelegt sein. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt.

Hinweis

Benutzer mit Beteiligtenzugriff für ein öffentliches Projekt besitzen ebenso wie Benutzer mit Standardzugriff Vollzugriff auf Abfragefunktionen. Weitere Informationen finden Sie unter Kurzreferenz zu Beteiligtenzugriff.

Öffnen von Abfragen

Browser

Wählen Sie in Ihrem Projekt Boards > Abfragen und dann Alle aus.

Die Seite Abfragen wird mit der Registerkarte Favoriten geöffnet, auf der die als Favoriten festgelegten Abfragen aufgeführt sind. Sie können die Registerkarte Alle auswählen, um alle Abfragen anzuzeigen, die Sie für das Projekt definiert haben oder die dafür freigegeben wurden.

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 der Seite Projekt angezeigt. Weitere Informationen finden Sie unter Festlegen von persönlichen oder Teamfavoriten.

Visual Studio

Wichtig

Es wird dringend empfohlen, dass alle die Standardansicht anstelle dieser Legacyansicht verwenden. Sie wurde speziell entwickelt, um schnell auf eine Liste von Arbeitselementen basierend auf „Mir zugewiesen“, „Gefolgt“, „Erwähnt“ oder „Aktuelle Updates“ zuzugreifen. Die Legacyansicht wird nicht mehr verbessert und voraussichtlich in einem zukünftigen Release von Visual Studio entfernt.

1. Wählen Sie auf der Homepage von Team Explorer die Option Arbeitselemente aus.

   

2. Um eine Abfrage zu öffnen, öffnen Sie das Kontextmenü für die Abfrage (klicken Sie mit der rechten Maustaste), und wählen Sie Ergebnisse anzeigen aus. Oder doppelklicken Sie auf die Abfrage, um sie zu öffnen.

   

Alternativ können Sie eine der folgenden Optionen auswählen:

• Abfrage bearbeiten: Öffnet den Abfrage-Editor für die ausgewählte Abfrage.
• Neue Abfrage: Öffnet den Abfrage-Editor mit den Standardoptionen für neue Abfragen.
• In Microsoft Excel öffnen (flach): Öffnet die Abfrage in Microsoft Excel.
• An Microsoft Outlook senden: Öffnen
• Ausschneiden: Schneidet die Abfrage aus. Anschließend können Sie die Abfrage in einen anderen Ordner einfügen.
• Kopieren: Kopiert die Abfrage. Anschließend können Sie die Abfrage in denselben oder einen anderen Ordner einfügen.
• Löschen: Löscht die Abfrage.
• Umbenennen: Ermöglicht das Umbenennen der Abfrage.
• Zu Favoriten hinzufügen: Fügt die Abfrage dem Abschnitt „Meine Favoriten“ hinzu.
• Zu Teamfavoriten hinzufügen: Fügt die Abfrage dem Abschnitt „Teamfavoriten“ hinzu.
• Sicherheit: Öffnet das Dialogfeld „Berechtigungen“ für die Abfrage.

Ausführen einer Abfrage in Azure Boards

Erweitern Sie zum Ausführen einer Abfrage einen Ordner, und wählen Sie den Titel der Abfrage aus. Die Ansicht wird geöffnet, um die Ergebnisse der Abfrage anzuzeigen.

Sie können eine Abfrage auch über die Azure DevOps-Befehlszeilenschnittstelle ausführen.

Browser

Tipp

Auf der Seite Abfragen wird wie bei anderen Webportalseiten die Ansicht gespeichert, zu der Sie zuletzt navigiert sind, und Sie werden wieder zu dieser Ansicht zurückgeleitet.

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 in Ihrem Projekt freigegeben sind.

   

2. Wählen Sie bei Bedarf Meine Abfragen aus.

   • Um alle Ihnen zugewiesenen Arbeitselemente anzuzeigen, wählen Sie Mir zugewiesen aus. Diese Abfrage verwendet das Makro @Me, um alle Ihnen zugewiesenen Arbeitselemente aufzulisten.
   • Um alle Arbeitselemente anzuzeigen, denen Sie folgen, wählen Sie Arbeitselemente, denen gefolgt wird aus. Diese Abfrage verwendet das Makro @Follows (ID in @Follows), um alle Arbeitselemente aufzulisten, denen Sie folgen möchten. Weitere Informationen dazu finden Sie unter Einem Arbeitselement oder Pull Request folgen.

3. Wählen Sie Freigegebene Abfragen aus, um den Ordner zu erweitern und auf Abfragen zuzugreifen, die als freigegebene Abfragen gespeichert wurden.

Visual Studio

Wichtig

Es wird dringend empfohlen, dass alle die Standardansicht anstelle dieser Legacyansicht verwenden. Sie wurde speziell entwickelt, um schnell auf eine Liste von Arbeitselementen basierend auf „Mir zugewiesen“, „Gefolgt“, „Erwähnt“ oder „Aktuelle Updates“ zuzugreifen. Die Legacyansicht wird nicht mehr verbessert und voraussichtlich in einem zukünftigen Release von Visual Studio entfernt.

• Öffnen Sie auf der Team Explorer-Seite Arbeitselemente das Kontextmenü für die Abfrage (durch Klicken mit der rechten Maustaste), und wählen Sie Ergebnisse anzeigen aus. Alternativ können Sie die Abfrage auch per Doppelklick öffnen.

  

Ausführen einer Abfrage über die Befehlszeile

Sie können eine Abfrage in der CLI mit dem Befehl az boards query 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 „--path“ oder „--wiql“ ist angegeben.
• wiql: Die Abfrage im WIQL-Format (Work Item Query Language). Wird ignoriert, wenn --id oder --path angegeben ist.
• path: Der Pfad einer vorhandenen Abfrage. Wird ignoriert, wenn „--id“ angegeben ist.
• org: Azure DevOps-Organisations-URL. Sie können die Standard-organization mit az devops configure -d organization=ORG_URLkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.
• project: Name oder ID des Projekts. Sie können das Standardprojekt mit az devops configure -d project=NAME_OR_IDkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird.

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

Hinweis

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

Browser

Die Seite Abfragen enthält die Registerkarten Favoriten und Alle. Jede Registerkarte enthält eine verzeichnisorientierte Ansicht, die Sie filtern können, um bestimmte Abfragen von Interesse zu finden.

Wenn Sie auf den Abfrageseiten arbeiten, können Sie zu einem Ordner, einem Unterordner oder einer Abfrageseite navigieren.

Sie können auch eine bevorzugte Abfrage auswählen oder über das Dropdownmenü einer geöffneten Abfrage zur Seite Alle Abfragen zurückkehren.

Visual Studio

Auf der Seite Arbeitselemente wird dieselbe Ordnerstruktur angezeigt, die auch im Webportal definiert ist. Änderungen, die Sie über Visual Studio vornehmen, werden im Webportal widergespiegelt.

Sie können Ordner erweitern und reduzieren, Ordner umbenennen und Abfragen per Drag & Drop von einem Ordner in einen anderen verschieben. Weitere Informationen finden Sie unter Verwalten und Organisieren von Abfragen

Weitere Informationen finden Sie unter Häufig gestellte Fragen zu Abfragen – Navigieren und Ordner.

Von „Alle“ und „Favoriten“ unterstützte Aufgaben

Sie können die meisten Aufgaben zum Anzeigen und Ausführen von Abfragen über die einzelnen Abfragelistenseiten ausführen, wie in der folgenden Tabelle angegeben. Nur Abfragen, die Sie unter Meine Abfragen speichern und als Favoriten festgelegt haben, werden unter Meine Favoriten angezeigt. Nur Abfragen, die unter Freigegebene Abfragen gespeichert sind, können von einem Team als Favoriten festgelegt werden.

Aufgabe	Favoriten (Browser)	Alle (Browser)	Arbeitselemente (Team Explorer)
Anzeigen aller als Favoriten festgelegten Abfragen (Ihre Abfragen oder Abfragen eines Teams, dem Sie angehören)	✔️		✔️
Anzeigen aller Abfragen oder freigegebenen Abfragen für das aktuelle Projekt		✔️	✔️
Ausführen einer Abfrage, Öffnen des Kontextmenüs für eine Abfrage	✔️	✔️	✔️
Erweitern oder Reduzieren von Containerordnern oder Abfrageordnern	✔️	✔️	✔️
Filtern der Abfrageliste	✔️	✔️
Festlegen einer Abfrage als Favoriten (Wählen Sie im Webportal aus.)		✔️
Entfernen einer Abfrage aus Favoriten (Wählen Sie im Webportal aus.)	✔️	✔️	✔️
Hinzufügen einer neuen Abfrage: Wählen Sie aus.	✔️	✔️	✔️

Filtern der Abfrageliste

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

Weitere Informationen finden Sie unter Häufig gestellte Fragen zu Abfragen – Navigieren und Ordner.

Senden von Abfrageelementen per E-Mail oder Freigeben einer Abfrage-URL

Browser

Im Abfrage-Editor oder in der Ansicht Ergebnisse können Sie eine formatierte Liste mit Abfrageelementen per E-Mail senden oder die Abfrage-URL kopieren.

Wählen Sie das Symbol für weitere Aktionen aus, um das Menü zu öffnen, und wählen Sie eine der aufgeführten Optionen aus: Abfrage per E-Mail senden oder Abfrage-URL kopieren.

Sie können die E-Mail nur an die individuelle Adresse eines Projektmitglieds senden, die vom System erkannt wird. Das Hinzufügen einer Team- oder Sicherheitsgruppe zur Zeile „An:“ wird nicht unterstützt. Wenn Sie ein E-Mail-Konto hinzufügen, das das System nicht erkennt, erhalten Sie die Nachricht, dass mindestens ein Empfänger Ihrer E-Mail nicht berechtigt ist, die per E-Mail gesendeten Arbeitselemente zu lesen.

Hinweis

Um eine formatierte Liste per E-Mail an Personen zu senden, die keine Projektmitglieder sind, müssen Sie die Option Als HTML kopieren verwenden. Eine Beschreibung dieser Option finden Sie unter Kopieren einer Liste mit Arbeitselementen. Bei einer lokalen Azure DevOps-Instanz muss für alle E-Mail-Aktionen ein SMTP-Server konfiguriert sein. Wenn Sie keinen SMTP-Server konfiguriert haben, können Sie dies umgehen, indem Sie Als HTML kopieren verwenden.

Visual Studio

Sie können eine formatierte Abfrageliste per E-Mail senden, indem Sie im Kontextmenü die Option An Microsoft Outlook senden auswählen.

Hinweis

Für dieses Feature muss Microsoft Outlook installiert sein. Bei einer lokalen Azure DevOps-Instanz muss für alle E-Mail-Aktionen ein SMTP-Server konfiguriert sein. Wenn Sie keinen SMTP-Server konfiguriert haben, können Sie dies umgehen, indem Sie im Webportal Als HTML kopieren verwenden.

Nächste Schritte

Definieren einer Abfrage

Verwandte Artikel

• Verwalten von Abfragen und Abfrageordnern
• Interaktives Filtern von Backlogs, Boards, Abfragen und Plänen
• Optionen zum Ändern von Spalten
• Persönliche oder Team-Favoriten festlegen
• Tastenkombinationen