Test Suites - Create

Référence

Service:: Test

API Version:: 5.0

Créez une suite de tests.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
planId	path	True	integer int32	ID du plan de test qui contient la suite.
project	path	True	string	ID de projet ou nom du projet
suiteId	path	True	integer int32	ID de la suite parente.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
name	string	Nom de la suite de tests.
queryString	string	Pour les suites basées sur des requêtes, chaîne de requête qui définit la suite.
requirementIds	integer[]	Pour les suites de tests de configuration requise, les ID des exigences.
suiteType	string	Type de suite de tests à créer. Il peut avoir une valeur de DynamicTestSuite, StaticTestSuite et RequirementTestSuite.

Réponses

Nom	Type	Description
200 OK	TestSuite[]	opération réussie

Sécurité

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

Nom	Description
vso.test_write	Accorde la possibilité de lire, créer et mettre à jour des plans de test, des cas, des résultats et d’autres artefacts liés à la gestion des tests.

Exemples

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
}

Définitions

Nom	Description
IdentityRef
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
ShallowReference	Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.
SuiteCreateModel	Créer un modèle de suite
TestSuite	Suite de tests

IdentityRef

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor	string	Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique dans les comptes et les organisations.
directoryAlias	string
displayName	string	Il s’agit du nom d’affichage non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

ShallowReference

Référence abstraite à une autre ressource. Cette classe est utilisée pour fournir aux contrats de données de build un moyen uniforme de référencer d’autres ressources de manière à faciliter la traversée des liens.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource liée (nom de la définition, nom du contrôleur, etc.)
url	string	Lien HTTP complet vers la ressource

SuiteCreateModel

Créer un modèle de suite

Nom	Type	Description
name	string	Nom de la suite de tests.
queryString	string	Pour les suites basées sur des requêtes, chaîne de requête qui définit la suite.
requirementIds	integer[]	Pour les suites de tests de configuration requise, les ID des exigences.
suiteType	string	Type de suite de tests à créer. Il peut avoir une valeur de DynamicTestSuite, StaticTestSuite et RequirementTestSuite.

TestSuite

Suite de tests

Nom	Type	Description
areaUri	string	URI de zone de la suite de tests.
children	TestSuite[]	Suites de tests enfants de la suite de tests actuelle.
defaultConfigurations	ShallowReference[]	Configuration par défaut de la suite de tests.
defaultTesters	ShallowReference[]	Testeurs par défaut de la suite de tests.
id	integer	ID de la suite de tests.
inheritDefaultConfigurations	boolean	La configuration par défaut a été héritée ou non.
lastError	string	Dernière erreur pour la suite de tests.
lastPopulatedDate	string	Date du dernier remplissage.
lastUpdatedBy	IdentityRef	IdentityRef de l’utilisateur qui a récemment mis à jour la suite de tests.
lastUpdatedDate	string	Date de la dernière mise à jour.
name	string	Nom de la suite de tests.
parent	ShallowReference	Référence superficielle parente de la suite de test.
plan	ShallowReference	Plan de test auquel appartient la suite de tests.
project	ShallowReference	Référence de projet superficiel de la suite de tests.
queryString	string	Chaîne de requête de la suite de test, pour les suites dynamiques.
requirementId	integer	ID des conditions requises de la suite de test.
revision	integer	Révision de la suite de tests.
state	string	État de la suite de tests.
suiteType	string	Type de suite de test.
suites	ShallowReference[]	Liste des références superficielles des suites.
testCaseCount	integer	Nombre de cas de test.
testCasesUrl	string	URL du cas de test.
text	string	Utilisé dans l’arborescence. Si la suite de tests est une suite racine, c’est le nom du plan, sinon le titre de la suite.
url	string	URL de la suite de tests.

Partager via

Test Suites - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

oauth2

Scopes

Exemples

Based on a query

Sample Request

Sample Response

Based on requirements

Sample Request

Sample Response

Static suite

Sample Request

Sample Response

Définitions

IdentityRef

ReferenceLinks

ShallowReference

SuiteCreateModel

TestSuite

Ressources supplémentaires