Test Suites - Create
Créez une suite de tests.
POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/suites/{suiteId}?api-version=5.0Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
|
plan
|
path | True |
integer int32 |
ID du plan de test qui contient la suite. |
|
project
|
path | True |
string |
ID de projet ou nom du projet |
|
suite
|
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 |
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
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
{
"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
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
{
"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
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
{
"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 |
|---|---|
|
Identity |
|
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Shallow |
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. |
|
Suite |
Créer un modèle de suite |
|
Test |
Suite de tests |
IdentityRef
| Nom | Type | Description |
|---|---|---|
| _links |
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 |
Suites de tests enfants de la suite de tests actuelle. |
|
| defaultConfigurations |
Configuration par défaut de la suite de tests. |
|
| defaultTesters |
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 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 |
Référence superficielle parente de la suite de test. |
|
| plan |
Plan de test auquel appartient la suite de tests. |
|
| project |
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 |
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. |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour