Freigeben über

Batchaktualisierung für Arbeitsaufgaben

Dienst : Arbeitsaufgabenverfolgungs-API Version : 4.1 Führt mehrere Aktualisierungsanforderungen für Arbeitsaufgaben durch. Die Antwort enthält einzelne Antworten für jede Anforderung im Batch. Fehlgeschlagene Anforderungen wirken sich nicht auf nachfolgende Anforderungen im Batch aus.

Arbeitsaufgabenstruktur

Eine Arbeitsaufgabe kann in einer folgenden Dateistruktur visualisiert werden.

WorkItem(id, rev)
|__Fields
|   |__ReferenceName
|__Relations
    |__WorkItemLinkReferenceNames
    |__ArtifactLink
    |__AttachedFile
    |__Hyperlink

REST-API-SEMANTIK

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

URI-Parameter

Name In Erforderlich Typ BESCHREIBUNG
accountName Pfad Richtig Schnur Der Name des Azure DevOps Services-Kontos.
api-version Anfrage Schnur Version der zu verwendenden API. Dies sollte auf "4.1" festgelegt werden, um diese Version der API zu verwenden.
bypassRules Anfrage Boolescher Wert Erzwingen Sie nicht die Regeln für den Arbeitsaufgabentyp für dieses Update.
suppressNotifications Anfrage Boolescher Wert Löst keine Benachrichtigungen für diese Änderung aus.

Anfragekörper

Medientyp : "application/json-patch+json" Jede Anforderung ist eine Sammlung einzelner Anforderungen für verschiedene Arbeitsaufgaben. Jede einzelne Anforderung besteht aus drei Hauptschlüsseln.

  1. op: Vorgang, der für eine Arbeitsaufgabe ausgeführt werden soll (kann add/remove/update usw.)
  2. pfad: Wo der Vorgang für eine Arbeitselementdateistruktur ausgeführt werden soll.
  3. wert: Wert des angegebenen Vorgangs.

Operation Der Patchvorgang

Name Typ
kopieren Schnur
bewegen Schnur
entfernen Schnur
ersetzen Schnur
test Schnur

Beispiele

  1. Hinzufügen/Aktualisieren eines Felds.
  2. Fügen Sie einen Arbeitsaufgabenlink hinzu.
  3. Hinzufügen eines Links.
  4. Fügen Sie eine angefügte Datei hinzu.
  5. Fügen Sie einen Artefaktlink hinzu.(z. B. Build, Pullrequest, Commit usw.)
  6. Entfernen sie einen Arbeitsaufgabenlink.
  7. Entfernen Sie einen Artefaktlink.
  8. Entfernen eines Links.
  9. Entfernen sie eine Remoteverbindung.
  10. Entfernen sie eine Anlage.
  11. Fall, bei dem eine einzelne Anforderung in der Batch-API fehlschlägt.
  12. Erstellen sie mehrere Arbeitsaufgaben.

    Typen

    Arbeitsaufgabenbeziehung

    Name Typ BESCHREIBUNG
    Attributen <string, object> Sammlung von Verknüpfungsattributen.
    Rel Schnur Beziehungstyp.
    url Schnur Link-URL.

    Work Item-Objekt

    Name Typ BESCHREIBUNG
    _Verknüpfungen [ReferenceLinks] Verknüpfen Sie Verweise auf verwandte REST-Ressourcen.
    fields <string, object> Zuordnung von Feld und Werten für die Arbeitsaufgabe.
    id Integer Die Arbeitsaufgaben-ID.
    relations WorkItemRelation Beziehungen der Arbeitsaufgabe.
    auf Touren bringen Integer Revisionsnummer der Arbeitsaufgabe.
    url Schnur URL zu dieser Arbeitsaufgabe