Arbeitselementverfolgung

  • Artikel

Arbeitsaufgabennachverfolgungsressourcen

Sie können Fehler, Tasks und andere Arbeitselemente für Ihr Team abrufen, erstellen und aktualisieren. Mithilfe von Abfragen können Sie die Abfragesprache der Arbeitselemente umfassend nutzen, um nach Arbeitselementen zu suchen und diese zu filtern. Sie können die Abfragesprache verwenden, um alle Arbeitselemente abzurufen, die der Abfrage entsprechen. Für Arbeitselemente wird die vollständige Versionsgeschichte gespeichert, und Sie können jede vollständige Revision des Arbeitselements oder nur die in jeder Revision vorgenommenen Aktualisierungen abrufen. Arbeitselemente können auch markiert werden.

Häufige Aufgaben

Abrufen von Arbeitselementen mithilfe einer Abfrage

  1. Suchen Sie nach der Abfrage , die Sie verwenden möchten.
  2. Rufen Sie die Ergebnisse für diese Abfrage ab.
  3. Rufen Sie alle Arbeitselemente nach ID ab.

Aktualisieren von WorkItems im Batch

Verwenden Sie die Batch WorkItem Update-API , um Ihre Arbeitselemente im Batch zu aktualisieren.

Aktualisieren der Felder eines Arbeitselements

  1. Rufen Sie die ID des Arbeitselements ab , das Sie aktualisieren möchten.
  2. Aktualisieren Sie die Felder des Arbeitselements.
  1. Rufen Sie die ID der Arbeitselemente ab , die Sie verknüpfen möchten.
  2. Fügen Sie einen Link zwischen den Arbeitselementen hinzu.

Verwenden Sie das Erstellen eines Arbeitselements , und fügen Sie in einem Batchaufruf eine Link-APIs hinzu.

Anfügen einer Datei an ein Arbeitselement

  1. Rufen Sie die ID des Arbeitselements ab , das Sie aktualisieren möchten.
  2. Laden Sie die Anlage in den Anlagespeicher hoch.
  3. Fügen Sie die Anlage dem Arbeitselement hinzu.

Erstellen eines Arbeitselements

Erstellen Sie ein Arbeitselement. Stellen Sie sicher, dass Sie mindestens einen Titel angeben. Einige Arten von Arbeitselementen erfordern Werte für andere Felder.

Abrufen des vollständigen Verlaufs eines Arbeitselements

  1. Rufen Sie die ID des Arbeitselements ab.
  2. Rufen Sie eine Liste der Updates ab, die an einem Arbeitselement vorgenommen wurden.
  3. Rufen Sie das gesamte Arbeitselement so ab, wie es in jeder Revision angezeigt wurde.

Löschen eines Arbeitselements

  1. Rufen Sie die ID des Arbeitselements ab.
  2. Löschen Sie das Arbeitselement.

Abrufen der in einem Teamprojekt verwendeten Felder

  1. Rufen Sie die Typen von Arbeitselementen ab, die in einem Teamprojekt verwendet werden.
  2. Rufen Sie jeden Arbeitselementtyp ab, um die von ihr verwendeten Felder anzuzeigen. (Überspringen Sie das XML-Formular zu fieldinstances.)

Abrufen von Kategorien von Arbeitselementen

Verwenden Sie Kategorien von Arbeitselementen , um die Typen von Arbeitselementen abzurufen, die in einem Teamprojekt für verschiedene Funktionen verwendet werden. Um beispielsweise die Arbeitselemente anzuzeigen, die im Backlog angezeigt werden, rufen Sie die Anforderungskategorie ab.

Abrufen von Bereichen und Iterationen

Rufen Sie die Bereichshierarchie oder Iterationshierarchie für Ihr Teamprojekt ab.

Abrufen von Typen von Arbeitselementbeziehungen

Rufen Sie die verfügbaren Typen von Arbeitselementlinks ab, die in Ihrer Projektsammlung verfügbar sind.

Metadatenressourcen für Arbeitselemente

Arbeitselemente werden durch Metadaten gesteuert. Einige der Metadaten sind auf ein bestimmtes Teamprojekt ausgerichtet, und andere Metadaten sind auf eine Projektsammlung (z. B. die Standardsammlung Ihres Azure DevOps Services-Kontos) ausgerichtet.

Projektbezogene Metadaten

Ihr Teamprojekt verfügt über eine Reihe von Arbeitselementtypen. Jeder Arbeitselementtyp kann zu einer Kategorie wie "Anforderung" oder "Fehler" gehören, um seine Rolle im Projekt zu definieren. Klassifizierungsknoten definieren den Satz von Werten, die in den Bereichen und Iterationsfeldern für die Arbeitselemente im Teamprojekt verwendet werden können.

Metadaten im Sammlungsbereich

Arbeitselementtypen teilen Felder und Beziehungstypen (Links und Anlagen) mit anderen Typen von Arbeitselementen.

Aktualisierungs-API für Arbeitselementbatches

Führt mehrere Anforderungen zum Aktualisieren von Arbeitselementen aus. Die Antwort enthält individuelle Antworten für jede Anforderung im Batch. Fehlerhafte Anforderungen wirken sich nicht auf nachfolgende Anforderungen im Batch aus.

REST-API-SEMANTIK

PATCH https://dev.azure.com/{organization}/_apis/wit/$batch?api-version=6.1

URI-Parameter

Name Geben Sie in Erforderlich Typ BESCHREIBUNG
organization Pfad True Zeichenfolge Der Name der Azure DevOps-Organisation.
api-version Abfrage Zeichenfolge Version der zu verwendenden API.
bypassRules Abfrage boolean Erzwingen Sie die Arbeitselementtypregeln für dieses Update nicht.
unterdrückenNotifications Abfrage boolean Lösen Sie keine Benachrichtigungen für diese Änderung aus.

Anforderungstext

Der Anforderungstext besteht aus einer Liste von Anforderungen zum Aktualisieren von Arbeitselementen. Jedes Element aus dieser Liste führt alle Informationen zu einer einzelnen Updateanforderung zusammen, einschließlich REST-Methode, Pfad, Headern und Text.

Ausführliche Informationen zu einer einzelnen Anforderung finden Sie in der Dokumentation zum Aktualisieren von Arbeitselementen .

Beispiel für Batchupdates

Anforderung

PATCH https://dev.azure.com/fabrikam/_apis/wit/$batch?api-version=6.1

Anforderungstext

[
  {
    // Add priority and test rev on work item with id 1
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/1?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "test",
        "path": "/rev",
        "value": 3
      },
      {
        "op": "add",
        "path": "/fields/Microsoft.VSTS.Common.Priority",
        "value": "1"
      }
    ]
  },
  {
    // Replace tags on work item with id 299x   
    "method": "PATCH",
    "uri": "/_apis/wit/workitems/299?api-version=6.1",
    "headers": {
      "Content-Type": "application/json-patch+json"
    },
    "body": [
      {
        "op": "replace",
        "path": "/fields/System.Tags",
        "value": "Tag1; Tag2"
      }
    ]
  },
  {
    // You can also use Work Item Create format
    "method": "PATCH",
    "uri": "/mytestprojectname/_apis/wit/workitems/$Bug?api-version=4.1",
    "headers": {
        "Content-Type": "application/json-patch+json"
    },
    "body": [
        {
            "op": "add",
            "path": "/id",
            "value": "-1"
        },
        {
            "op": "add",
            "path": "/fields/System.Title",
            "from": null,
            "value": "Sample 1"
        }
    ]
  },
]

Antwort

Die Antwort besteht aus einzelnen Antworten für jede batchierte Updateanforderung.

  • Anzahl : Anzahl der zurückgegebenen Batchantworten für Updates
  • value : Liste der Antwortobjekte mit Antwortcode, Headern und Text
{
  "count": 2,
  "value": [
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    },
    {
      "code": 200,
      "headers": {
        "Content-Type": "application/json; charset=utf-8"
      },
      "body": "{work item object}"
    }
  ]
}