Partager via

Suite Test Case - Get Test Case List

  • Référence
Service:
Test Plan
Version d'API:
7.1

Obtenir la liste des cas de test retourne les cas de test qui ont tous les ID de configuration, comme indiqué dans le paramètre facultatif. Si les ID de configuration sont null, il retourne tous les cas de test

GET https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/{planId}/Suites/{suiteId}/TestCase?api-version=7.1
Avec des paramètres facultatifs: 
GET https://dev.azure.com/{organization}/{project}/_apis/testplan/Plans/{planId}/Suites/{suiteId}/TestCase?testIds={testIds}&configurationIds={configurationIds}&witFields={witFields}&continuationToken={continuationToken}&returnIdentityRef={returnIdentityRef}&expand={expand}&excludeFlags={excludeFlags}&isRecursive={isRecursive}&api-version=7.1

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 pour lequel les cas de test sont demandés.
project
 path True

string

ID de projet ou nom du projet
suiteId
 path True

integer (int32)

ID de la suite de tests pour laquelle les cas de test sont demandés.
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.
configurationIds
 query

string

Récupérez les cas de test qui contiennent tous les ID de configuration spécifiés.
continuationToken
 query

string

Si la liste des cas de test retournés n’est pas terminée, un jeton de continuation pour interroger le lot suivant de cas de test est inclus dans l’en-tête de réponse « x-ms-continuationtoken ». Omettez ce paramètre pour obtenir le premier lot de cas de test.
excludeFlags
 query

ExcludeFlags

Indicateur permettant d’exclure différentes valeurs de la charge utile. Par exemple, pour supprimer la passe d’affectations de points, excluez = 1. Pour supprimer des informations supplémentaires (liens, plan de test, suite de tests) passez l’exclusion = 2. Pour supprimer à la fois les informations supplémentaires et le passage des affectations de points, excluez = 3 (1 + 2).
expand
 query

boolean

Si la valeur est false, obtient une charge utile plus petite contenant uniquement des détails de base sur l’objet de cas de test de suite
isRecursive
 query

boolean

returnIdentityRef
 query

boolean

Si la valeur est true, retourne tous les champs d’identité, tels que AssignedTo, ActivatedBy, etc., en tant qu’objets IdentityRef. Si la valeur est false, ces champs sont retournés sous forme de noms uniques au format de chaîne. Cette valeur est false par défaut.
testIds
 query

string

ID de cas de test à extraire.
witFields
 query

string

Obtenez la liste des witFields.

Réponses

Nom Type Description
200 OK

TestCase[]

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.

Définitions

Nom Description
ExcludeFlags

Indicateur permettant d’exclure différentes valeurs de la charge utile. Par exemple, pour supprimer la passe d’affectations de points, excluez = 1. Pour supprimer des informations supplémentaires (liens, plan de test, suite de tests) passez l’exclusion = 2. Pour supprimer à la fois les informations supplémentaires et le passage des affectations de points, excluez = 3 (1 + 2).
IdentityRef
PointAssignment

Affectations pour le point de test
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.
TestCase

Test Case, classe
TestPlanReference

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

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

Classe d’élément de travail

ExcludeFlags

Énumération

Indicateur permettant d’exclure différentes valeurs de la charge utile. Par exemple, pour supprimer la passe d’affectations de points, excluez = 1. Pour supprimer des informations supplémentaires (liens, plan de test, suite de tests) passez l’exclusion = 2. Pour supprimer à la fois les informations supplémentaires et le passage des affectations de points, excluez = 3 (1 + 2).

Valeur Description
extraInformation

Pour exclure des informations supplémentaires (liens, plan de test, suite de tests), passez exclure = 2
none

Pour exclure rien
pointAssignments

Pour exclure les affectations de points, passez exclure = 1

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.

PointAssignment

Object

Affectations pour le point de test

Nom Type Description
configurationId

integer (int32)

ID de la configuration affectée au point de test
configurationName

string

Nom de la configuration affectée au point de test
id

integer (int32)

ID du point de test
tester

IdentityRef

Testeur affecté au point de test

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.
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.

TestCase

Object

Test Case, classe

Nom Type Description
links

ReferenceLinks

Liens de référence
order

integer (int32)

Ordre de testCase dans la suite
pointAssignments

PointAssignment[]

Liste des points associés au cas de test
project

TeamProjectReference

Projet sous lequel le cas de test est
testPlan

TestPlanReference

Plan de test sous lequel le cas de test est
testSuite

TestSuiteReference

Suite de tests sous laquelle le cas de test est
workItem

WorkItemDetails

Détails de l’élément de travail du TestCase

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.

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.

WorkItemDetails

Object

Classe d’élément de travail

Nom Type Description
id

integer (int32)

ID de l’élément de travail
name

string

Nom de l’élément de travail
workItemFields

object[]

Champs d’élément de travail