Test Suites - Get Suites By Test Case Id

Référence

Service:: Test Plan

Version d'API:: 7.1

Recherchez la liste de toutes les suites de tests dans lesquelles un cas de test donné est présent. Cela est utile si vous devez savoir quelles suites de tests utilisent un cas de test, lorsque vous devez apporter des modifications à un cas de test.

GET https://dev.azure.com/{organization}/_apis/testplan/suites?testCaseId={testCaseId}&api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
testCaseId	query	True	integer (int32)	ID du cas de test pour lequel les suites doivent être extraites.

Réponses

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

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.test	Accorde la possibilité de lire des plans de test, des cas, des résultats et d’autres artefacts associés à la gestion des tests.

Exemples

Get a test suites which contains testcase across projects.

Exemple de requête

HTTP

GET https://dev.azure.com/fabrikam/_apis/testplan/suites?testCaseId=6&api-version=7.1

Exemple de réponse

Code d’état:: 200

persistent-Auth: true
lfs-Authenticate: NTLM
wwW-Authenticate: Negotiate oRswGaADCgEAoxIEEAEAAACnYEZorOY4LgAAAAA=

{
  "count": 3,
  "value": [
    {
      "id": 5,
      "revision": 1,
      "project": {
        "id": "499b955d-7143-4382-932e-9cd17df45f83",
        "name": "MyProject",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/MyProject",
        "state": "unchanged",
        "visibility": "unchanged"
      },
      "lastPopulatedDate": "2018-08-31T04:21:57.297Z",
      "lastUpdatedBy": {
        "displayName": "Fabrikam Fiber",
        "url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.MGZkYmRhZDgtNmFmYi03MTQ5LTlhZjktYzBhMjE2MTM3ZDFk"
          }
        },
        "id": "9b6bee0e-28b2-42b6-ab5b-5122b63d473c",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "descriptor": "win.Uy0xLTUtMjEtMjE0Njc3MzA4NS05MDMzNjMyODUtNzE5MzQ0NzA3LTIwMjE0OTM"
      },
      "lastUpdatedDate": "2018-08-28T09:27:24.503Z",
      "plan": {
        "id": 1,
        "name": "Test Plan 1"
      },
      "_links": {
        "_self": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/testplan/Plans/1/Suites/5"
        },
        "testCases": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/1/Suites/5/TestCases"
        },
        "testPoints": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/1/Suites/5/Points"
        }
      },
      "suiteType": "requirementTestSuite",
      "requirementId": 4,
      "name": "4 : us1",
      "parentSuite": {
        "id": 3,
        "name": "TS1"
      },
      "inheritDefaultConfigurations": true
    },
    {
      "id": 83,
      "revision": 3,
      "project": {
        "id": "499b955d-7143-4382-932e-9cd17df45f83",
        "name": "MyProject",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/MyProject",
        "state": "unchanged",
        "visibility": "unchanged"
      },
      "lastPopulatedDate": "2018-09-03T06:49:34.83Z",
      "lastUpdatedBy": {
        "displayName": "Fabrikam Fiber",
        "url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.MGZkYmRhZDgtNmFmYi03MTQ5LTlhZjktYzBhMjE2MTM3ZDFk"
          }
        },
        "id": "9b6bee0e-28b2-42b6-ab5b-5122b63d473c",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "descriptor": "win.Uy0xLTUtMjEtMjE0Njc3MzA4NS05MDMzNjMyODUtNzE5MzQ0NzA3LTIwMjE0OTM"
      },
      "lastUpdatedDate": "2018-08-31T12:28:23.55Z",
      "plan": {
        "id": 79,
        "name": "Sample Test Plan"
      },
      "_links": {
        "_self": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/testplan/Plans/79/Suites/83"
        },
        "testCases": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/79/Suites/83/TestCases"
        },
        "testPoints": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/79/Suites/83/Points"
        }
      },
      "suiteType": "requirementTestSuite",
      "requirementId": 4,
      "name": "4 : us1",
      "parentSuite": {
        "id": 80,
        "name": "Sample Test Plan"
      },
      "inheritDefaultConfigurations": true
    },
    {
      "id": 84,
      "revision": 1,
      "project": {
        "id": "499b955d-7143-4382-932e-9cd17df45f83",
        "name": "MyProject",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/MyProject",
        "state": "unchanged",
        "visibility": "unchanged"
      },
      "lastPopulatedDate": "2018-09-03T06:45:55.843Z",
      "lastUpdatedBy": {
        "displayName": "Fabrikam Fiber",
        "url": "https://vssps.dev.azure.com/fabrikam/Aea08ebc7-105f-4bb2-a36b-f92e0e9de65a/_apis/Identities/0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.MGZkYmRhZDgtNmFmYi03MTQ5LTlhZjktYzBhMjE2MTM3ZDFk"
          }
        },
        "id": "9b6bee0e-28b2-42b6-ab5b-5122b63d473c",
        "uniqueName": "fabrikamfiber1@microsoft.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=0fdbdad8-6afb-6149-9af9-c0a216137d1d",
        "descriptor": "win.Uy0xLTUtMjEtMjE0Njc3MzA4NS05MDMzNjMyODUtNzE5MzQ0NzA3LTIwMjE0OTM"
      },
      "lastUpdatedDate": "2018-08-31T10:11:53.12Z",
      "plan": {
        "id": 79,
        "name": "Sample Test Plan"
      },
      "_links": {
        "_self": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/testplan/Plans/79/Suites/84"
        },
        "testCases": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/79/Suites/84/TestCases"
        },
        "testPoints": {
          "href": "https://dev.azure.com/fabrikam/MyProject/_apis/test/Plans/79/Suites/84/Points"
        }
      },
      "suiteType": "dynamicTestSuite",
      "name": "New query-based suite",
      "parentSuite": {
        "id": 80,
        "name": "Sample Test Plan"
      },
      "queryString": "select [System.Id], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Common.Priority], [System.AssignedTo], [System.AreaPath] from WorkItems where [System.TeamProject] = @project and [System.WorkItemType] in group 'Microsoft.TestCaseCategory' and [System.AreaPath] under 'MyProject'",
      "inheritDefaultConfigurations": true
    }
  ]
}

Définitions

Nom	Description
IdentityRef
ProjectState	État du projet.
ProjectVisibility	Visibilité du projet.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
TeamProjectReference	Représente une référence superficielle à un TeamProject.
TestConfigurationReference	Informations de référence sur la configuration de test
TestPlanReference	Ressource de référence du plan de test.
TestSuite	Suite de tests
TestSuiteReference	Ressource de référence de la suite de tests.
TestSuiteType	Type de suite de test.

IdentityRef

Object

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. 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 sur les comptes et les organisations.
directoryAlias	string	Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom complet non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string	Déconseillé - Disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »
inactive	boolean	Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »
isAadIdentity	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
uniqueName	string	Déconseillé : utiliser Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.

ProjectState

Énumération

État du projet.

Valeur	Description
all	Tous les projets, quel que soit l’état, sauf supprimé.
createPending	Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.
deleted	Le projet a été supprimé.
deleting	Le projet est en cours de suppression.
new	Le projet est en cours de création.
unchanged	Le projet n’a pas été modifié.
wellFormed	Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Énumération

Visibilité du projet.

Valeur	Description
private	Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.
public	Le projet est visible pour tous.

ReferenceLinks

Object

Classe à 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 de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TeamProjectReference

Object

Représente une référence superficielle à un TeamProject.

Nom	Type	Description
abbreviation	string	Abréviation du projet.
defaultTeamImageUrl	string	URL de l’image d’identité d’équipe par défaut.
description	string	Description du projet (le cas échéant).
id	string (uuid)	Identificateur du projet.
lastUpdateTime	string (date-time)	Heure de la dernière mise à jour du projet.
name	string	Nom du projet.
revision	integer (int64)	Révision du projet.
state	ProjectState	État du projet.
url	string	URL vers la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.

TestConfigurationReference

Object

Informations de référence sur la configuration de test

Nom	Type	Description
id	integer (int32)	ID de la configuration
name	string	Nom de la configuration

TestPlanReference

Object

Ressource de référence du plan de test.

Nom	Type	Description
id	integer (int32)	ID du plan de test.
name	string	Nom du plan de test.

TestSuite

Object

Suite de tests

Nom	Type	Description
_links	ReferenceLinks	Liens : auto, testPoints, testCases, parent
children	TestSuite[]	Suites de tests enfants de la suite de test actuelle.
defaultConfigurations	TestConfigurationReference[]	Configurations par défaut de la suite de test.
defaultTesters	IdentityRef[]	Testez les testeurs par défaut de la suite de tests.
hasChildren	boolean	Valeur booléenne dictée si les suites de tests enfants sont présentes
id	integer (int32)	ID de la suite de test.
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-time)	Date du dernier remplissage.
lastUpdatedBy	IdentityRef	IdentityRef de l’utilisateur qui a récemment mis à jour la suite de tests.
lastUpdatedDate	string (date-time)	Date de la dernière mise à jour.
name	string	Nom de la suite de tests.
parentSuite	TestSuiteReference	Référence superficielle parent de la suite de test.
plan	TestPlanReference	Plan de test auquel appartient la suite de tests.
project	TeamProjectReference	Référence superficielle du projet de suite de test.
queryString	string	Chaîne de requête de suite de test pour les suites dynamiques.
requirementId	integer (int32)	ID de configuration requise de la suite de test.
revision	integer (int32)	Révision de la suite de test.
suiteType	TestSuiteType	Type de suite de test.

TestSuiteReference

Object

Ressource de référence de la suite de tests.

Nom	Type	Description
id	integer (int32)	ID de la suite de tests.
name	string	Nom de la suite de tests.

TestSuiteType

Énumération

Type de suite de test.

Valeur	Description
dynamicTestSuite	Suite de tests basée sur des requêtes
none	Type de suite par défaut
requirementTestSuite	Suite de tests basée sur les conditions requises
staticTestSuite	Static Test Suite

Partager via

Test Suites - Get Suites By Test Case Id

Paramètres URI

Réponses

Sécurité

oauth2

Étendues

Exemples

Get a test suites which contains testcase across projects.

Exemple de requête

Exemple de réponse

Définitions

IdentityRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectReference

TestConfigurationReference

TestPlanReference

TestSuite

TestSuiteReference

TestSuiteType