Vlastní pole

  • Článek

Služby Azure DevOps

Použití vlastních polí umožňuje ukládat vlastní data proti testovacímu spuštění nebo výsledku testu. Pro jeden projekt Azure DevOps může být definováno až 100 vlastních polí. Správce projektu může spravovat (přidat nebo odstranit) sadu vlastních polí.

Správa vlastních polí

Vlastní pole můžete spravovat dvěma způsoby – buď prostřednictvím rozhraní REST API , nebo správce projektu, může to provést prostřednictvím nastavení projektu a zvolit správu testů v části Kanály. Na této stránce můžete přidat nové vlastní pole kliknutím na tlačítko + Přidat nový .

Snímek obrazovky nastavení projektu s vybraným nastavením správy testů a tlačítkem pro přidání nového vlastního pole označeného červeným obdélníkem

Pokud chcete přidat nové vlastní pole, zvolte + Přidat nové . Každé vlastní pole musí mít název, typ nakonfigurovaný a indikuje, na jaký typ artefaktu se vztahuje.

Snímek obrazovky s dialogovým oknem použitým k přidání nového vlastního pole

Název vlastního pole nesmí být delší než 50 znaků (mezery, čísla a speciální znaky nejsou povoleny) a musí být v projektu jedinečný. Názvy nerozlišují malá a velká písmena, takže nemůžete mít jedno vlastní pole s názvem "Test" a druhé s názvem "test". Typ může být jeden z následujících typů:

  • Bit
  • DateTime
  • Int
  • Float
  • String
  • Guid

Existující vlastní pole je možné upravit (změnit pouze název) nebo je odebrat.

Poznámka:

Po odebrání vlastního pole nemůžete jeho název použít asi na den. Proces na pozadí, který odebírá odstraněná vlastní pole trvale, se spouští každý den.

Ukládání vlastních dat do vlastních polí

Vlastní data můžete uložit do nakonfigurovaných vlastních polí buď jako součást vytvoření testovacího běhu nebo výsledku, nebo po vytvoření testovacího spuštění nebo výsledku. Obě možnosti je teď možné provádět pomocí rozhraní REST API. V budoucnu povolíme vyzvednutí vlastních dat ze souboru výsledků testu. Pokud chcete získat hodnoty uložené ve vlastních polích pro stávající testovací běh nebo výsledek, musíte použít rozhraní REST API. V okamžiku, kdy vlastní pole a hodnoty uložené v těchto polích nezobrazíme v uživatelském rozhraní Azure DevOps (tuto schopnost přidáme v budoucnu).

Při vytváření testovacího spuštění nebo výsledku prostřednictvím rozhraní REST API a chcete uložit vlastní data do existujícího vlastního pole, je nejlepší volbou odeslat vlastní data jako součást testovacího běhu nebo vytvoření výsledku. Vytvoření volání testovacího spuštění – Spuštění rozhraní REST API – Vytvoření a vytvoření volání výsledku testu – Výsledky rozhraní REST API – Přidat

Pokud se testovací běh nebo výsledek nevytvořil prostřednictvím rozhraní REST API, ale jinými prostředky, musíte nejprve najít identifikaci testovacího spuštění nebo výsledku, pro který chcete nastavit (nebo aktualizovat) vlastní data ve vlastních polích a potom volat spuštění rozhraní REST API – aktualizovat pro testovací běh a výsledky rozhraní REST API – Aktualizovat výsledek testu.

Pokud chcete načíst vlastní data z vlastních polí uložených dříve proti testovacímu běhu nebo výsledku, musíte nejprve najít identifikaci testovacího běhu nebo výsledku. Pak můžete volat spuštění rozhraní REST API – dotaz na testovací běh a výsledky rozhraní REST API – Získat výsledek testu.

Vlastní data pro vlastní pole se odesílají nebo přijímají v poli. Každá položka pole obsahuje dvě vlastnosti "fieldname" a "value" a můžete vidět příklad tohoto pole. Hodnota je objekt typu, který odpovídá typu nakonfigurovaného pro vlastní pole. Abyste pochopili typ vlastního pole, můžete použít rozhraní REST API , které poskytuje pole vlastních polí. Pro každé pole najdete jeho ID, název, typ a obor. Typ můžete také pevně zakódovat, pokud víte, jaký je typ vlastního pole s daným názvem.