Freigeben über


Arbeitselemente nach Anzahl von Links oder Anhängen abfragen

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

Verknüpfen Sie Arbeitsaufgaben, um verwandte Arbeiten und Abhängigkeiten nachzuverfolgen, und fügen Sie Dateien an, um Informationen mit Ihrem Team zu teilen. Abfragen von Arbeitselementen mit den folgenden Feldern:

Tipp

Sie können KI verwenden, um diese Aufgabe zu unterstützen weiter unten in diesem Artikel, oder lesen Sie Enable AI-Unterstützung bei Azure DevOps MCP Server, um zu beginnen.

  • Anzahl angefügter Dateien
  • Anzahl von (Diskussions-)Kommentaren
  • Anzahl externer Verknüpfungen
  • Anzahl von Hyperlinks
  • Kommentar zur Verknüpfung
  • Anzahl zugehöriger Links
  • Anzahl der Remote-Links
  • Anzahl angefügter Dateien
  • Anzahl von (Diskussions-)Kommentaren
  • Anzahl externer Verknüpfungen
  • Anzahl von Hyperlinks
  • Kommentar zur Verknüpfung
  • Anzahl zugehöriger Links

Ausführliche Feldbeschreibungen finden Sie unter "Felder", die Links und Anlagen zugeordnet sind.

Voraussetzungen

Kategorie Anforderungen
Zugriffsebenen – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied.
- Zum Hinzufügen und Speichern einer gemeinsam verwendeten Abfrage: Mindestens Basic-Zugriff.
Erlaubnisse Die Berechtigung Mitwirken ist für den Ordner, dem Sie die Abfrage hinzufügen möchten, auf Zulassen festgelegt. 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 Schnellreferenz für Stakeholder-Zugriff.

Kategorie Anforderungen
Zugriffsebenen – Anzeigen und Ausführen von gemeinsamen Abfragen: Projektmitglied.
- Zum Hinzufügen und Speichern einer gemeinsam verwendeten Abfrage: Mindestens Basic-Zugriff.
Erlaubnisse Die Berechtigung Mitwirken ist für den Ordner, dem Sie die Abfrage hinzufügen möchten, auf Zulassen festgelegt. Diese Berechtigung ist für die Gruppe Mitwirkende standardmäßig nicht festgelegt.

Unterstützte Operatoren und Makros

Verwenden Sie die folgenden Operatoren für Klauseln, die ein ganzzahliges Feld angeben:

= , <> , > , < , >= , <=
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
In, Not In
Was Ever

Auflisten hierarchischer Elemente in einer Strukturansicht

Erstellen Sie eine Abfrage und wählen Sie Baum der Arbeitselemente, um zu beginnen. Die Query Editor zeigt die folgenden Beispiele:

Hinweis

Sie können keine Abfrage erstellen, die eine hierarchische Ansicht von Testplänen, Testsuiten und Testfällen anzeigt, da diese Elemente nicht durch übergeordnete und untergeordnete Verknüpfungstypen miteinander verknüpft sind. Verwenden Sie eine direkte Verknüpfungsabfrage, um testbezogene Arbeitsaufgaben auflisten oder die Hierarchie auf der Seite "Testpläne" anzuzeigen.

Optionen für Filter und Abfrageklauseln

Ändern Sie die Filteroptionen für verknüpfte Arbeitsaufgaben, und fügen Sie Abfrageklauseln hinzu, indem Sie die Optionen im Query Editor verwenden.

Filtern nach

Diese Abfrageklauseln einschließen

Nur untergeordnete Elemente des Arbeitselements 645

Zu Filtern für Arbeitselemente auf oberster Ebene hinzufügen:
ID = 645

Aufgaben oder Fehler

Zu Filtern für verknüpfte Arbeitselemente hinzufügen:
Work Item Type In Task,Bug

Elemente, die meinem Team zugewiesen sind (Web)

Hinzufügen zu Ober- und Unterseitenfiltern:
Assigned to In Group [Fabrikam Fiber]\Web

Übergeordnete Elemente von Aufgaben, die mir zugewiesen sind

Filteroptionen ändern zu Zuerst verknüpfte Arbeitselemente abgleichen
Zu Filtern für verknüpfte Arbeitselemente hinzufügen:
Assigned To = @Me

Auflisten von Elementen basierend auf verknüpften Abhängigkeiten

Im folgenden Beispiel wird eine abhängige verknüpfte Abfrage gezeigt, die Elemente mit Abhängigkeiten von Aufgaben zurückgibt, die von anderen Teams und Projekten verwaltet werden:

Die folgende Abfrage findet Arbeitsaufgaben in allen Projekten, die mit Arbeitsaufgaben unter dem Pfad des Fabrikam-Bereichs und des Projekts mithilfe der Verknüpfungstypen "Vorgänger" und "Nachfolger" verknüpft sind.

Screenshot einer Abfrage mit direkten Links im Webportal.

  • Wählen Sie "Abfrage zwischen Projekten" aus, um abhängige verknüpfte Arbeitsaufgaben aus anderen Projekten einzuschließen.
  • Fügen Sie die Area Path Under Fabrikam-Klausel hinzu, um nach Arbeitsaufgaben zu filtern, die mit Elementen verknüpft sind, die im Fabrikam-Projekt definiert sind.
  • Wählen Sie nur Elemente mit übereinstimmenden Links zurück, und wählen Sie dann "Ausgewählte Verknüpfungstypen zurückgeben " aus, um nur Arbeitsaufgaben zurückzugeben, die als Vorgänger oder Nachfolger verknüpft sind.

Auflisten verwaister User Storys

Wenn Sie Benutzergeschichten unter Features organisieren, finden Sie schnell nicht zugeordnete Benutzergeschichten, indem Sie eine der folgenden Aktionen ausführen:

  1. Öffnen Sie das Product Backlog, und aktivieren Sie die Ansichtsoption Übergeordnete Elemente „ein“.
  2. Scrollen Sie zum Abschnitt Elternlose Geschichten (Agile) oder Elternlose Backlog-Elemente (Scrum).

Screenshot des Produktrückstands mit nicht zugeordneten Stories.

Oder suchen Sie verwaiste Backlog-Elemente mithilfe einer Arbeitselemente- und Direktlinks-Abfrage. In der folgenden Abfrage werden beispielsweise aktive Benutzergeschichten des Azure DevOps-Teams aufgelistet, die keinen übergeordneten Link haben.

Screenshot, der den Query-Editor für nicht zugeordnete Benutzergeschichten im Webportal anzeigt.

In der folgenden Tabelle werden Felder beschrieben, die Links und Anlagen zugeordnet sind. Die meisten dieser Felder werden nicht im Arbeitsaufgabenformular angezeigt, sondern für alle Arbeitsaufgabentypen nachverfolgt.

Anzahl angefügter Dateien

Die Anzahl der Dateien, die an das Arbeitselement angefügt und in der Datenbank zur Arbeitselementnachverfolgung gespeichert sind.
Verweisname=System.AttachedFileCount, Datentyp=Integer

Hinweis

Für Azure Boards (Clouddienst) können Sie einer Arbeitsaufgabe bis zu 100 Anlagen hinzufügen. Versuche, mehr hinzuzufügen, führen zu einer Fehlermeldung, wenn Sie das Arbeitselement speichern.

Kommentaranzahl

Die Anzahl von Kommentaren, die dem Abschnitt Diskussion des Arbeitselements hinzugefügt wurden.
Verweisname=System.CommentCount, Datentyp=Integer

Anzahl externer Links

Die Anzahl der Verknüpfungen vom Arbeitselement zu Artefakten, die keine Arbeitselemente sind, z. B. Pull-Anfragen, Commits, Änderungssätze oder andere Verknüpfungstypen.
Verweisname=System.ExternalLinkCount, Datentyp=Integer

Anzahl von Hyperlinks

Die Anzahl der Hyperlinks, die die Arbeitsaufgabe enthält.

Verweisname=System.HyperLinkCount, Datentyp=Integer

Kommentar zur Verknüpfung

Enthält Kommentare des Teammitglieds, das den Link erstellt hat. Sie können dieses Feld so konfigurieren, dass es in einem Arbeitselementformular als Spalte in einer Liste mit Links angezeigt wird. (Das Query Editor unterstützt dieses Feld nicht.)

Verweisname=System.Links.Comment, Datentyp=PlainText

Linkbeschreibung

Enthält den Arbeitselementtyp, die ID und den Titel des Arbeitselements, das das Ziel des Links darstellt. Sie können dieses Feld so konfigurieren, dass es in einem Arbeitselementformular als Spalte in einer Liste mit Links angezeigt wird. (Das Query Editor unterstützt dieses Feld nicht.)

Verweisname=System.Links.Description, Datentyp=PlainText

Parent

Wenn sie als Spaltenoption in eine Backlog- oder Abfrageergebnisliste eingeschlossen wird, zeigt das System den Titel der übergeordneten Arbeitsaufgabe an. Intern speichert das System die ID der Arbeitsaufgabe in einem Feld "Integer".

Hinweis

Sie können das Feld Übergeordnetes Element als Spalte hinzufügen oder es in einer Abfrageklausel angeben, indem Sie die ID des übergeordneten Arbeitselements angeben.
Verweisname=System.Parent, Datentyp=Integer

Anzahl zugehöriger Links

Die Anzahl von Links, die für ein Arbeitselement definiert sind, das einen Arbeitslinktyp wie „Über- und untergeordnet“, „Vorgänger-Nachfolger“ oder „Zugehörig“ verwendet. Eine vollständige Liste finden Sie in der Referenz zu Linktypen.
Verweisname=System.RelatedLinkCount, Datentyp=Integer

Anzahl von Remotelinks

Nur für Azure DevOps Services verfügbar. Die Anzahl von Links von einem Arbeitselement zu Arbeitselementen, die in einer anderen Organisation definiert sind. Dieselbe Microsoft Entra ID muss die Organisationen verwalten. Unterstützte Linktypen sind „Verbraucht aus“, „Produziert für“ und „Remotebezogen“. Weitere Informationen finden Sie unter Hinzufügen eines Links zu Arbeitselementen, Verknüpfen mit einem Remotearbeitselement.
Verweisname=System.RemoteLinkCount, Datentyp=Integer

Verwenden Sie die Erweiterung Arbeitsaufgabenvisualisierung aus dem Visual Studio Marketplace über die Registerkarte Azure DevOps, um verwandte Arbeitsaufgaben und Objekte innerhalb einer Arbeitsaufgabe anzuzeigen.

Informationen zum Hinzufügen von Linktypen finden Sie unter Verwalten von Linktypen [witadmin].

Alle Registerkarten, die das Erstellen von Verknüpfungen zwischen Arbeitsaufgaben unterstützen, verwenden das LinksControl-Element im Arbeitsaufgabenformular. Dieses Element steuert die Filterung und schränkt die Typen von Arbeitsaufgaben ein, mit denen Sie eine Verknüpfung herstellen können. Außerdem werden die Typen von Verknüpfungen gesteuert, die Sie erstellen können, und ob Sie Arbeitsaufgaben in einem anderen Projekt verknüpfen können. Um die Verknüpfungssteuerelemente und -einschränkungen anzupassen, ändern Sie die Definition des LinksControlOptions Arbeitselementtyps; siehe LinksControlOptions-XML-Elemente.

Sie können der Linkliste Spalten hinzufügen oder daraus entfernen, und Sie können die Standardspalten und die Spaltenreihenfolge anpassen. Weitere Informationen finden Sie unter LinksControlOptions-XML-Elemente.

Wenn Sie den Azure Boards MCP Server mit Ihrem KI-Agent im Agentmodus verbunden haben, können Sie Eingaben in natürlicher Sprache verwenden, um Arbeitsaufgaben basierend auf ihren Links und Anlagen zu finden.

Aufgabe Beispielprompt
Nicht verknüpfte Elemente suchen Find active user stories with no child task links
Abfrage nach Anhängen List bugs that have attached files
Überprüfung von Entwicklungslinks Show work items with no linked commits or pull requests
Suchen von stark verknüpften Elementen Find work items with more than 3 related links
Abhängigkeitsketten verfolgen Show all work items in <Contoso> that have predecessor links and list what they depend on
Suchen von Elementen mit externen Links List work items in <Contoso> that have hyperlinks in their links
Prüfen der Integrität von Eltern-Kind-Beziehungen. Show child work items in <Contoso> whose parent is in the Closed state but the child is still Active
Suchen von Elementen, die mit Testfällen verknüpft sind List user stories in the current sprint for <Contoso> that have linked test cases and show the test outcome
Anlagenblähung identifizieren Show work items in <Contoso> that have more than 5 attachments
Projektübergreifende Links suchen List work items in <Contoso> that have related links to work items in other projects

Hinweis

Der Agentmodus und der MCP-Server verwenden natürliche Sprache, sodass Sie diese Eingabeaufforderungen anpassen oder Nachverfolgungsfragen stellen können, um die Ergebnisse zu verfeinern.