Test Suites - Create

Reference

Služba:: Test

Verze rozhraní API:: 5.0

Vytvořte sadu testů.

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/suites/{suiteId}?api-version=5.0

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
planId	path	True	integer int32	ID testovacího plánu, který obsahuje sadu.
project	path	True	string	ID projektu nebo název projektu
suiteId	path	True	integer int32	ID nadřazené sady
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na hodnotu 5.0.

Text požadavku

Name	Typ	Description
name	string	Název sady testů
queryString	string	Pro sady založené na dotazech řetězec dotazu, který definuje sadu.
requirementIds	integer[]	Pro testovací sady požadavků id požadavků.
suiteType	string	Typ sady testů, která se má vytvořit. Může mít hodnotu z DynamicTestSuite, StaticTestSuite a RequirementTestSuite.

Odpovědi

Name	Typ	Description
200 OK	TestSuite[]	úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Rozsahy

Name	Description
vso.test_write	Uděluje možnost číst, vytvářet a aktualizovat testovací plány, případy, výsledky a další artefakty související se správou testů.

Příklady

Based on a query

Based on requirements

Static suite

Based on a query

Ukázkový požadavek

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/suites/1?api-version=5.0

{
  "suiteType": "DynamicTestSuite",
  "name": "AllTestCases",
  "queryString": "SELECT [System.Id],[System.WorkItemType],[System.Title],[Microsoft.VSTS.Common.Priority],[System.AssignedTo],[System.AreaPath] FROM WorkItems WHERE [System.WorkItemType] IN GROUP 'Microsoft.TestCaseCategory'"
}

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "id": 9,
      "name": "AllTestCases",
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/9",
      "project": {
        "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
        "name": "Fabrikam-Fiber-TFVC",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
      },
      "plan": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "queryString": "SELECT [System.Id],[System.WorkItemType],[System.Title],[Microsoft.VSTS.Common.Priority],[System.AssignedTo],[System.AreaPath] FROM WorkItems WHERE [System.WorkItemType] IN GROUP 'Microsoft.TestCaseCategory'",
      "revision": 1,
      "testCaseCount": 2,
      "suiteType": "DynamicTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/9/testcases",
      "inheritDefaultConfigurations": true,
      "lastPopulatedDate": "2014-05-04T11:33:28.497Z",
      "state": "InProgress",
      "lastUpdatedBy": {
        "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "displayName": "Fabrikam Fiber",
        "uniqueName": "fabrikamfiber1@outlook.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
      },
      "lastUpdatedDate": "2014-05-04T11:33:28.497Z"
    }
  ],
  "count": 1
}

Based on requirements

Ukázkový požadavek

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/suites/1?api-version=5.0

{
  "suiteType": "RequirementTestSuite",
  "requirementIds": [
    2
  ]
}

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "id": 13,
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/13",
      "project": {
        "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
        "name": "Fabrikam-Fiber-TFVC",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
      },
      "plan": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "name": "2 : BestFeatureEver",
      "requirementId": 2,
      "revision": 1,
      "testCaseCount": 0,
      "suiteType": "RequirementTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/13/testcases",
      "inheritDefaultConfigurations": true,
      "defaultConfigurations": [],
      "lastPopulatedDate": "2014-05-04T11:33:25.857Z",
      "state": "InProgress",
      "lastUpdatedBy": {
        "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "displayName": "Fabrikam Fiber",
        "uniqueName": "fabrikamfiber1@outlook.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
      },
      "lastUpdatedDate": "2014-05-04T11:33:25.857Z",
      "areaUri": "vstfs:///Classification/Node/13a29f1c-46be-4883-9153-b36900f1b70c"
    }
  ],
  "count": 1
}

Static suite

Ukázkový požadavek

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/suites/1?api-version=5.0

{
  "suiteType": "StaticTestSuite",
  "name": "NewTestSuite"
}

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "id": 8,
      "name": "NewTestSuite",
      "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/8",
      "project": {
        "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
        "name": "Fabrikam-Fiber-TFVC",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
      },
      "plan": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1"
      },
      "parent": {
        "id": "1",
        "name": "sprint1",
        "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/1"
      },
      "revision": 1,
      "testCaseCount": 0,
      "suiteType": "StaticTestSuite",
      "testCasesUrl": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/Suites/8/testcases",
      "inheritDefaultConfigurations": true,
      "state": "InProgress",
      "lastUpdatedBy": {
        "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "displayName": "Fabrikam Fiber",
        "uniqueName": "fabrikamfiber1@outlook.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
      },
      "lastUpdatedDate": "2014-05-04T11:33:25.857Z"
    }
  ],
  "count": 1
}

Definice

Name	Description
IdentityRef
ReferenceLinks	Třída představující kolekci odkazů REST.
ShallowReference	Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.
SuiteCreateModel	Vytvoření modelu sady
TestSuite	Sada testů

IdentityRef

Object

Name	Typ	Description
_links	ReferenceLinks	Toto pole neobsahuje žádný nebo více zajímavých odkazů na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.
descriptor	string	Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.
directoryAlias	string
displayName	string	Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

ReferenceLinks

Object

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

ShallowReference

Object

Abstraktní odkaz na nějaký jiný prostředek. Tato třída se používá k poskytování kontraktů dat sestavení s jednotným způsobem odkazování na jiné prostředky způsobem, který umožňuje snadné procházení prostřednictvím odkazů.

Name	Typ	Description
id	string	ID prostředku
name	string	Název propojeného prostředku (název definice, název kontroleru atd.)
url	string	Úplný odkaz HTTP na prostředek

SuiteCreateModel

Object

Vytvoření modelu sady

Name	Typ	Description
name	string	Název sady testů
queryString	string	Pro sady založené na dotazech řetězec dotazu, který definuje sadu.
requirementIds	integer[]	Pro testovací sady požadavků id požadavků.
suiteType	string	Typ sady testů, která se má vytvořit. Může mít hodnotu z DynamicTestSuite, StaticTestSuite a RequirementTestSuite.

TestSuite

Object

Sada testů

Name	Typ	Description
areaUri	string	Identifikátor URI oblasti sady testů.
children	TestSuite[]	Podřízené testovací sady aktuální sady testů.
defaultConfigurations	ShallowReference[]	Výchozí konfigurace sady testů
defaultTesters	ShallowReference[]	Výchozí testeři sady testů.
id	integer	ID sady testů.
inheritDefaultConfigurations	boolean	Výchozí konfigurace se zdědila nebo ne.
lastError	string	Poslední chyba testovací sady.
lastPopulatedDate	string	Datum posledního naplnění.
lastUpdatedBy	IdentityRef	IdentityRef uživatele, který nedávno aktualizoval sadu testů.
lastUpdatedDate	string	Datum poslední aktualizace.
name	string	Název sady testů
parent	ShallowReference	Test suite parent shallow reference.
plan	ShallowReference	Testovací plán, do kterého patří sada testů.
project	ShallowReference	Odkaz na projekt testovací sady je mělký.
queryString	string	Řetězec dotazu testovací sady pro dynamické sady
requirementId	integer	ID požadavku sady testů
revision	integer	Revize sady testů.
state	string	Stav sady testů.
suiteType	string	Typ testovací sady.
suites	ShallowReference[]	Seznam povrchních odkazů sad.
testCaseCount	integer	Počet testovacích případů
testCasesUrl	string	Adresa URL testovacího případu
text	string	Používá se ve stromovém zobrazení. Pokud je testovací sada kořenová sada, jedná se o název plánu, jinak název sady.
url	string	Adresa URL sady testů

Sdílet prostřednictvím

Test Suites - Create

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

oauth2

Rozsahy

Příklady

Based on a query

Ukázkový požadavek

Ukázková odpověď

Based on requirements

Ukázkový požadavek

Ukázková odpověď

Static suite

Ukázkový požadavek

Ukázková odpověď

Definice

IdentityRef

ReferenceLinks

ShallowReference

SuiteCreateModel

TestSuite

Další materiály