Test Suites - Create

Başvuru

Service:: Test

API Version:: 5.0

Bir test paketi oluşturun.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
planId	path	True	integer int32	Paketi içeren test planının kimliği.
project	path	True	string	Proje Kimliği veya proje adı
suiteId	path	True	integer int32	Üst paketin kimliği.
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '5.0' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
name	string	Test paketinin adı.
queryString	string	Sorgu tabanlı paketler için paketi tanımlayan sorgu dizesi.
requirementIds	integer[]	Gereksinimler test paketleri için gereksinimlerin kimlikleri.
suiteType	string	Oluşturulacak test paketinin türü. DynamicTestSuite, StaticTestSuite ve RequirementTestSuite değerlerini içerebilir.

Yanıtlar

Name	Tür	Description
200 OK	TestSuite[]	başarılı işlem

Güvenlik

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: 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

Scopes

Name	Description
vso.test_write	Test planlarını, çalışmalarını, sonuçlarını ve test yönetimiyle ilgili diğer yapıtları okuma, oluşturma ve güncelleştirme olanağı sağlar.

Örnekler

Based on a query

Based on requirements

Static suite

Based on a query

Sample Request

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'"
}

Sample Response

Status code:: 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

Sample Request

HTTP

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

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

Sample Response

Status code:: 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

Sample Request

HTTP

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

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

Sample Response

Status code:: 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
}

Tanımlar

Name	Description
IdentityRef
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
ShallowReference	Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.
SuiteCreateModel	Paket oluşturma modeli
TestSuite	Test paketi

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusuyla ilgili sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında ek ilişkiler veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

ShallowReference

Başka bir kaynağa soyut başvuru. Bu sınıf, derleme veri sözleşmelerine diğer kaynaklara bağlantılar arasında kolay geçiş sağlayacak şekilde başvurmak için tekdüzen bir yol sağlamak için kullanılır.

Name	Tür	Description
id	string	Kaynağın kimliği
name	string	Bağlı kaynağın adı (tanım adı, denetleyici adı vb.)
url	string	Kaynağa tam http bağlantısı

SuiteCreateModel

Paket oluşturma modeli

Name	Tür	Description
name	string	Test paketinin adı.
queryString	string	Sorgu tabanlı paketler için paketi tanımlayan sorgu dizesi.
requirementIds	integer[]	Gereksinimler test paketleri için gereksinimlerin kimlikleri.
suiteType	string	Oluşturulacak test paketinin türü. DynamicTestSuite, StaticTestSuite ve RequirementTestSuite değerlerini içerebilir.

TestSuite

Test paketi

Name	Tür	Description
areaUri	string	Test paketinin alan uri'si.
children	TestSuite[]	Geçerli test paketinin alt test paketleri.
defaultConfigurations	ShallowReference[]	Test paketi varsayılan yapılandırması.
defaultTesters	ShallowReference[]	Test paketi varsayılan test edicileri.
id	integer	Test paketinin kimliği.
inheritDefaultConfigurations	boolean	Varsayılan yapılandırma devralındı veya devralındı.
lastError	string	Test paketi için son hata.
lastPopulatedDate	string	Son doldurulan tarih.
lastUpdatedBy	IdentityRef	Yakın zamanda test paketini güncelleştiren kullanıcının IdentityRef değeri.
lastUpdatedDate	string	Son güncelleştirme tarihi.
name	string	Test paketinin adı.
parent	ShallowReference	Test paketi üst yüzeysel başvurusu.
plan	ShallowReference	Test paketinin ait olduğu test planı.
project	ShallowReference	Test paketi projesi yüzeysel başvurusu.
queryString	string	Dinamik paketler için test paketi sorgu dizesi.
requirementId	integer	Test paketi gereksinim kimliği.
revision	integer	Test paketi düzeltmesi.
state	string	Test paketinin durumu.
suiteType	string	Test paketi türü.
suites	ShallowReference[]	Paketlerin sığ başvuru listesi.
testCaseCount	integer	Test çalışmaları sayısı.
testCasesUrl	string	Test çalışması URL'si.
text	string	Ağaç görünümünde kullanılır. Test paketi kök paketse, paketin diğer adı planın adıdır.
url	string	Test paketinin url'si.

Aracılığıyla paylaş

Test Suites - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

oauth2

Scopes

Örnekler

Based on a query

Sample Request

Sample Response

Based on requirements

Sample Request

Sample Response

Static suite

Sample Request

Sample Response

Tanımlar

IdentityRef

ReferenceLinks

ShallowReference

SuiteCreateModel

TestSuite

Ek kaynaklar