Sdílet prostřednictvím

Sledování pracovních položek

  • Článek

Zdroje pro sledování pracovních položek

Pro svůj tým můžete získat, vytvořit a aktualizovat chyby, úlohy a další pracovní položky. Dotazy umožňují využít všechny možnosti dotazovacího jazyka pro pracovní položky k vyhledávání a filtrování pracovních položek. Pomocí dotazovacího jazyka pro pracovní položky můžete získat přístup ke každé pracovní položce, která odpovídá dotazu. Pracovní položky si uchovávají úplnou historii. Můžete tak získat každou kompletní revizi pracovní položky nebo pouze aktualizace provedené v jednotlivých revizích. Pracovní položky je také možné označovat.

Běžné úkoly

Získání pracovních položek pomocí dotazu

  1. Vyhledejte dotaz , který chcete použít.
  2. Získejte výsledky pro tento dotaz.
  3. Získejte každou pracovní položku podle ID.

Aktualizace pracovních položek v dávce

K aktualizaci pracovních položek v dávce použijte rozhraní API služby Batch WorkItem Update .

Aktualizace polí pracovní položky

  1. Získejte ID pracovní položky , kterou chcete aktualizovat.
  2. Aktualizujte pole pracovní položky.
  1. Získejte ID pracovních položek , které chcete propojit.
  2. Přidejte propojení mezi pracovní položky.

Použijte příkaz Vytvořit pracovní položku a přidejte rozhraní API pro propojení do dávkového volání.

Připojení souboru k pracovní položce

  1. Získejte ID pracovní položky , kterou chcete aktualizovat.
  2. Nahrajte přílohu do úložiště příloh.
  3. Přidejte přílohu k pracovní položce.

Vytvoření pracovní položky

Vytvořte pracovní položku. Ujistěte se, že jste zadali alespoň název. Některé typy pracovních položek budou vyžadovat hodnoty pro jiná pole.

Získání úplné historie pracovní položky

  1. Získejte ID pracovní položky.
  2. Získejte seznam aktualizací pracovních položek.
  3. Získejte celou pracovní položku tak, jak se objevila v libovolné revizi.

Odstranění pracovní položky

  1. Získejte ID pracovní položky.
  2. Odstraňte pracovní položku.

Získání polí použitých v týmovém projektu

  1. Získejte typy pracovních položek používaných v týmovém projektu.
  2. Získáním jednotlivých typů pracovních položek zobrazíte pole, která používá. (Přeskočte za xmlform na fieldinstances.)

Získání kategorií pracovních položek

Kategorie pracovních položek slouží k získání typů pracovních položek používaných v týmovém projektu pro různé funkce. Pokud chcete například zobrazit pracovní položky, které se zobrazují v backlogu, získejte kategorii požadavků.

Získání oblastí a iterací

Získejte hierarchii oblastí nebo hierarchii iterace pro týmový projekt.

Získání typů vztahů mezi pracovními položkami

Získejte dostupné typy odkazů na pracovní položky , které jsou k dispozici v kolekci projektů.

Zdroje metadat pracovní položky

Pracovní položky se řídí metadaty. Některá metadata jsou vymezená na konkrétní týmový projekt a jiná metadata jsou vymezená na kolekci projektů (například výchozí kolekce vašeho Azure DevOps Services účtu).

Metadata v rozsahu projektu

Týmový projekt má sadu typů pracovních položek. Každý typ pracovní položky může patřit do kategorie , například "požadavek" nebo "chyba", která definuje jeho roli v projektu. Klasifikační uzly definují sadu hodnot, které lze použít v polích oblasti a iterace pro pracovní položky v týmovém projektu.

Metadata s oborem kolekce

Typy pracovních položek sdílejí pole a typy relací (odkazy a přílohy) s jinými typy pracovních položek.

Rozhraní API dávkové aktualizace pracovních položek

Provede více žádostí o aktualizaci pracovních položek. Odpověď obsahuje jednotlivé odpovědi pro každý požadavek v dávce. Neúspěšné požadavky nemají vliv na další požadavky v dávce.

SÉMANTIKA ROZHRANÍ REST API

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

Parametry identifikátoru URI

Název V Požaduje se Typ Description
Organizace Cesta True řetězec Název organizace Azure DevOps.
verze-api query řetězec Verze rozhraní API, která se má použít.
bypassRules query boolean V této aktualizaci nevynucujte pravidla typu pracovní položky.
suppressNotifications query boolean Pro tuto změnu neaktivujte žádná oznámení.

Text požadavku

Text požadavku se skládá ze seznamu žádostí o aktualizaci pracovních položek. Každá položka z tohoto seznamu bude konatinovat všechny informace o jednom požadavku aktualizace, včetně metody REST, cesty, hlaviček a textu.

Podrobné informace o jedné žádosti najdete v dokumentaci k aktualizaci pracovních položek .

Příklad dávkové aktualizace

Žádost

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

Text požadavku

[
  {
    // 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"
        }
    ]
  },
]

Response (Odpověď)

Odpověď se skládá z individuálních odpovědí na každý dávkový požadavek na aktualizaci.

  • count : počet vrácených odpovědí na dávkové aktualizace
  • value : seznam objektů odpovědi s kódem odpovědi, hlavičkami a textem
{
  "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}"
    }
  ]
}