Test Plans - Create

Başvuru

Service:: Test

API Version:: 5.0

Bir test planı oluşturun.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API sürümü. Api'nin bu sürümünü kullanmak için bu değer '5.0' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
area	ShallowReference	Test planının ait olduğu alan yolu. Bu, bu test planında çalışan ekibin alan yoluna ayarlanmalıdır.
build	ShallowReference	Kalitesi bu test planındaki testler tarafından test edilen derlemenin derleme kimliği. Otomatik test için bu derleme kimliği, otomatik test yöntemlerini içeren test ikili dosyalarını bulmak için kullanılır.
buildDefinition	ShallowReference	Bu test planıyla ilişkilendirilmiş bir derleme oluşturan Derleme Tanımı.
configurationIds	integer[]	Test planına yeni test paketleri ve test çalışmaları eklendiğinde uygulanacak yapılandırmaların kimlikleri.
description	string	Test planının açıklaması.
endDate	string	Test planının bitiş tarihi.
iteration	string	Test planına atanan yineleme yolu. Bu, bu plandaki testin tamamlanması gereken hedef yinelemenin ne zaman tamamlanmasının gerektiğini ve ürünün piyasaya sürülmeye hazır olduğunu gösterir.
name	string	Test planının adı.
owner	IdentityRef	Test planının sahibi.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Derlemeyi dağıtmak ve bu test planından otomatikleştirilmiş testler çalıştırmak için kullanılacak Yayın Ortamı.
startDate	string	Test planının başlangıç tarihi.
state	string	Test planının durumu.
testOutcomeSettings	TestOutcomeSettings	Test Sonucu ayarları

Yanıtlar

Name	Tür	Description
200 OK	TestPlan	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 diğer test yönetimiyle ilgili yapıtları okuma, oluşturma ve güncelleştirme olanağı sağlar.

Örnekler

Create a test plan in an area and iteration.

Create a test plan with a description.

Create a test plan with start date and end date.

Create a test plan in an area and iteration.

Sample Request

HTTP

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

{
  "name": "ANewPlan",
  "area": {
    "name": "Fabrikam-Fiber-TFVC\\Quality assurance"
  },
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1"
}

Sample Response

Status code:: 200

{
  "id": 16,
  "name": "ANewPlan",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/16",
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "area": {
    "id": "411",
    "name": "Fabrikam-Fiber-TFVC\\Quality assurance"
  },
  "startDate": "2014-05-06T13:43:02.803578Z",
  "endDate": "2014-05-13T13:43:02.803578Z",
  "iteration": "Fabrikam-Fiber-TFVC\\Release 1",
  "updatedDate": "2014-05-06T13:43:02.187Z",
  "updatedBy": {
    "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"
  },
  "owner": {
    "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"
  },
  "revision": 1,
  "state": "Active",
  "rootSuite": {
    "id": "33",
    "name": "ANewPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/16/Suites/33"
  },
  "clientUrl": "mtms://fabrikam.visualstudio.com:443/DefaultCollection/p:Fabrikam-Fiber-TFVC/Testing/testplan/connect?id=16"
}

Create a test plan with a description.

Sample Request

HTTP

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

{
  "name": "newCreatedPlan",
  "description": "This is a new test plan"
}

Sample Response

Status code:: 200

{
  "id": 15,
  "name": "newCreatedPlan",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/15",
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "area": {
    "id": "343",
    "name": "Fabrikam-Fiber-TFVC"
  },
  "description": "This is a new test plan",
  "startDate": "2014-05-06T13:42:59.3008007Z",
  "endDate": "2014-05-13T13:42:59.3008007Z",
  "iteration": "Fabrikam-Fiber-TFVC",
  "updatedDate": "2014-05-06T13:42:58.71Z",
  "updatedBy": {
    "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"
  },
  "owner": {
    "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"
  },
  "revision": 1,
  "state": "Active",
  "rootSuite": {
    "id": "32",
    "name": "newCreatedPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/15/Suites/32"
  },
  "clientUrl": "mtms://fabrikam.visualstudio.com:443/DefaultCollection/p:Fabrikam-Fiber-TFVC/Testing/testplan/connect?id=15"
}

Create a test plan with start date and end date.

Sample Request

HTTP

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

{
  "name": "ANewPlan",
  "startDate": "2014-05-01",
  "endDate": "2014-05-10"
}

Sample Response

Status code:: 200

{
  "id": 17,
  "name": "ANewPlan",
  "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/17",
  "project": {
    "id": "eb6e4656-77fc-42a1-9181-4c6d8e9da5d1",
    "name": "Fabrikam-Fiber-TFVC",
    "url": "https://dev.azure.com/fabrikam/_apis/projects/Fabrikam-Fiber-TFVC"
  },
  "area": {
    "id": "343",
    "name": "Fabrikam-Fiber-TFVC"
  },
  "startDate": "2014-05-01T00:00:00Z",
  "endDate": "2014-05-10T00:00:00Z",
  "iteration": "Fabrikam-Fiber-TFVC",
  "updatedDate": "2014-05-06T13:43:04.743Z",
  "updatedBy": {
    "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"
  },
  "owner": {
    "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"
  },
  "revision": 1,
  "state": "Active",
  "rootSuite": {
    "id": "34",
    "name": "ANewPlan",
    "url": "https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/17/Suites/34"
  },
  "clientUrl": "mtms://fabrikam.visualstudio.com:443/DefaultCollection/p:Fabrikam-Fiber-TFVC/Testing/testplan/connect?id=17"
}

Tanımlar

Name	Description
IdentityRef
PlanUpdateModel	Test planları oluşturmak ve güncelleştirmek için kullanılan model sınıfı.
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
ReleaseEnvironmentDefinitionReference	Yayın ortamı kaynağına başvuru.
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.
TestOutcomeSettings	Test sonucu ayarları
TestPlan	Test planı kaynağı.

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusu hakkında sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında daha fazla ilişki 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.

PlanUpdateModel

Test planları oluşturmak ve güncelleştirmek için kullanılan model sınıfı.

Name	Tür	Description
area	ShallowReference	Test planının ait olduğu alan yolu. Bu, bu test planında çalışan ekibin alan yoluna ayarlanmalıdır.
build	ShallowReference	Kalitesi bu test planındaki testler tarafından test edilen derlemenin derleme kimliği. Otomatik test için bu derleme kimliği, otomatik test yöntemlerini içeren test ikili dosyalarını bulmak için kullanılır.
buildDefinition	ShallowReference	Bu test planıyla ilişkilendirilmiş bir derleme oluşturan Derleme Tanımı.
configurationIds	integer[]	Test planına yeni test paketleri ve test çalışmaları eklendiğinde uygulanacak yapılandırmaların kimlikleri.
description	string	Test planının açıklaması.
endDate	string	Test planının bitiş tarihi.
iteration	string	Test planına atanan yineleme yolu. Bu, bu plandaki testin tamamlanması gereken hedef yinelemenin ne zaman tamamlanmasının gerektiğini ve ürünün piyasaya sürülmeye hazır olduğunu gösterir.
name	string	Test planının adı.
owner	IdentityRef	Test planının sahibi.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Derlemeyi dağıtmak ve bu test planından otomatikleştirilmiş testler çalıştırmak için kullanılacak Yayın Ortamı.
startDate	string	Test planının başlangıç tarihi.
state	string	Test planının durumu.
testOutcomeSettings	TestOutcomeSettings	Test Sonucu ayarları

ReferenceLinks

REST başvuru bağlantıları 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 göstermek istiyoruz.

ReleaseEnvironmentDefinitionReference

Yayın ortamı kaynağına başvuru.

Name	Tür	Description
definitionId	integer	Yayın ortamı tanımını içeren yayın tanımının kimliği.
environmentDefinitionId	integer	Yayın ortamı tanımının kimliği.

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ı

TestOutcomeSettings

Test sonucu ayarları

Name	Tür	Description
syncOutcomeAcrossSuites	boolean	Paketler arasında aynı testlerin test sonuçlarının nasıl gösterileceğini yapılandırmaya yönelik değer

TestPlan

Test planı kaynağı.

Name	Tür	Description
area	ShallowReference	Test planının alanı.
build	ShallowReference	Test edilecek derleme.
buildDefinition	ShallowReference	Bu test planıyla ilişkilendirilmiş bir derleme oluşturan Derleme Tanımı.
description	string	Test planının açıklaması.
endDate	string	Test planının bitiş tarihi.
id	integer	Test planının kimliği.
iteration	string	Test planının yineleme yolu.
name	string	Test planının adı.
owner	IdentityRef	Test planının sahibi.
previousBuild	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.
project	ShallowReference	Test planını içeren proje.
releaseEnvironmentDefinition	ReleaseEnvironmentDefinitionReference	Derlemeyi dağıtmak ve bu test planından otomatikleştirilmiş testler çalıştırmak için kullanılacak Yayın Ortamı.
revision	integer	Test planının düzeltmesi.
rootSuite	ShallowReference	Test planının kök test paketi.
startDate	string	Test planının başlangıç tarihi.
state	string	Test planının durumu.
testOutcomeSettings	TestOutcomeSettings	Bir test planı altındaki test paketleri arasında aynı testlerin nasıl davranması gerektiğini yapılandırmaya değer
updatedBy	IdentityRef
updatedDate	string
url	string	Test planı kaynağının URL'si.

Aracılığıyla paylaş

Test Plans - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

oauth2

Scopes

Örnekler

Create a test plan in an area and iteration.

Sample Request

Sample Response

Create a test plan with a description.

Sample Request

Sample Response

Create a test plan with start date and end date.

Sample Request

Sample Response

Tanımlar

IdentityRef

PlanUpdateModel

ReferenceLinks

ReleaseEnvironmentDefinitionReference

ShallowReference

TestOutcomeSettings

TestPlan

Ek kaynaklar