Objet Req

Un objet Req représente une exigence.

Vous obtenez un objet Req à partir d’un Objet ReqFactory.

Méthodes publiques

Cet objet prend en charge les méthodes suivantes.

Méthode Description
AddCoverage

Affecte un test pour couvrir l’exigence actuelle.

Syntaxe : AddCoverage(testId)

Paramètres :

  • testId. Nombre qui représente l’ID du test affecté pour couvrir l’exigence.

AddCoverageEx

Affecte tous les tests dans le dossier de test spécifié pour couvrir l’exigence actuelle.

Syntaxe : AddCoverage(subjectId)

Paramètres :

  • subjectId. Nombre qui représente l’ID du dossier de test.

GetCoverageTestConfigs

Renvoie la liste des configurations de test qui couvrent l’exigence actuelle et, éventuellement, couvrent ses enfants qui correspondent au filtre d’exigence.

Syntaxe : GetCoverageTestConfigs(recursive)

Paramètres :

  • recursive. Booléen qui indique si la couverture des descendants de cette exigence doit ou non être vérifiée. Si la valeur est true, les configurations de test qui couvrent l’exigence actuelle et ses enfants sont renvoyées. Si la valeur est false, seules les configurations de test qui couvrent l’exigence actuelle sont renvoyées.

GetCoverageTestConfigsByTestIds

Renvoie la liste des configurations de test qui couvrent l’exigence actuelle avec des tests filtrés et, éventuellement, couvrent ses descendants qui correspondent au filtre d’exigence.

Syntaxe : GetCoverageTestConfigs(testId, recursive)

Paramètres :

  • testId. Chaîne qui représente une liste d’ID de test, séparés par des virgules.

  • recursive. Booléen qui indique si la couverture des descendants de cette exigence doit ou non être vérifiée. Si la valeur est true, les configurations de test filtrées qui couvrent l’exigence actuelle et ses enfants sont renvoyées. Si la valeur est false, seules les configurations de test filtrées qui couvrent l’exigence actuelle sont renvoyées.

GetCoverageTestsByReqFilter

Renvoie la liste des tests qui couvrent l’exigence actuelle et, éventuellement, couvrent ses enfants qui correspondent au filtre d’exigence.

Syntaxe : GetCoverageTestsByReqFilter(reqFilter, recursive)

Paramètres :

  • reqFilter. Chaîne TDFilter.Text qui spécifie les exigences de descendants à inclure. Pour récupérer tous les tests qui couvrent cette exigence, définissez le filtre sur une chaîne vide ou utilisez la méthode GetCoverList.

  • recursive. Booléen qui indique si la couverture des descendants de cette exigence doit ou non être vérifiée. Si la valeur est true, le filtre est appliqué à cette exigence et à ses descendants. Si la valeur est false, le filtre est appliqué uniquement à cette exigence.

GetCoverList

Obtient la liste des tests qui couvrent cette exigence.

Syntaxe : GetCoverList(recursive)

Paramètres :

  • recursive. Booléen qui indique si la couverture des descendants de cette exigence doit ou non être vérifiée. Si la valeur est true, cette méthode renvoie une liste de tests qui couvrent cette exigence et ses enfants. Si la valeur est false, elle renvoie uniquement les tests qui couvrent cette exigence.

GetCoverListByFilter

Obtient la liste de tous les tests qui couvrent l’exigence actuelle et correspondent au filtre.

Syntaxe : GetCoverList(testFilter, recursive)

Paramètres :

  • testFilter. Chaîne TDFilter.Text qui spécifie les tests à inclure.

  • recursive. Booléen qui indique si la couverture des descendants de cette exigence doit ou non être vérifiée. Si la valeur est true, cette méthode renvoie une liste des tests filtrés qui couvrent cette exigence et ses enfants. Si la valeur est false, elle renvoie uniquement les tests filtrés qui couvrent cette exigence.

LockObject

Verrouille l’objet. Renvoie la valeur True si l’objet a été modifié sur le serveur.

Pour plus d’informations, voir LockObject.

E-mail

Envoie une liste d’éléments.

Pour plus d’informations, voir E-mail.

Move

Déplace une exigence pour qu’elle soit un enfant d’un parent spécifié dans l’arborescence des exigences.

Syntaxe : Move(newFatherId, newOrder)

Paramètres :

  • newFatherId. Nombre qui représente l’ID de la nouvelle exigence parent désignée.

  • newOrder. Nombre qui représente la position de l’exigence sous le nouveau parent. Les valeurs acceptées sont :

    • Un nombre représentant la position.

    • tagTDAPI_POS_ORDER.TDPOSITION_LAST : indique que l’exigence est insérée en dernier.

En plus de déplacer l’exigence, la propriété Move déverrouille également celle-ci si elle est définie sur Autounlock.

PopulateTargetCycleToChildren

Affecte le cycle cible de l’exigence comme cycle cible de toutes les exigences enfants, de manière récursive dans l’arborescence des dossiers.

Syntaxe : PopulateTargetCycleToChildren()

PopulateTargetReleaseToChildren

Affecte la release cible de l’exigence comme release cible de toutes les exigences enfants, de manière récursive dans l’arborescence des dossiers.

Syntaxe : PopulateTargetReleaseToChildren()

Post

Publie toutes les valeurs modifiées dans la base de données.

Pour plus d’informations, voir  Post.

Actualiser

Lit les valeurs enregistrées, en écrasant les valeurs en mémoire.

Pour plus d’informations, voir  Actualiser.

RemoveCoverage

Supprime un test de la liste des tests qui couvrent cette exigence.

Syntaxe : RemoveCoverage(vTest, recursive)

Paramètres :

  • vTest. Un Objet Test ou un tableau d’objets de test.

  • recursive. Booléen qui indique si la couverture de test est supprimée pour l’exigence actuelle et toutes ses exigences enfants. Si la valeur est true, la couverture de test est supprimée pour toutes les exigences enfants. Si la valeur est false, la couverture de test est supprimée uniquement pour l’exigence actuelle.

Undo

Annule les modifications apportées aux valeurs de champ qui n’ont pas été publiées.

Pour plus d’informations, voir  Undo.

UnLockObject

Déverrouille l’objet.

Pour plus d’informations, voir UnLockObject.

Propriétés publiques

Cet objet prend en charge les propriétés suivantes.

Propriété R/W Type Description

Pièces jointes

R Objet

Fabrique de pièces jointes pour l’objet. Voir Objet AttachmentFactory.

Auteur

R/W Chaîne

Nom de l’auteur de l’exigence.

AutoPost

R/W Booléen

Si cette valeur est définie sur true, la base de données est mise à jour immédiatement lorsque la valeur du champ change.

AutoUnlock

R/W Booléen

Indique si l’élément doit être automatiquement modifiable par d’autres utilisateurs après une actualisation ou une publication.

Commentaire

R/W Chaîne

Commentaire associé à cette exigence.

Count

R Nombre

Nombre d’enfants directs.

Champ

R/W Any

Valeur du champ spécifié.

Syntaxe : Req.Field[fieldName]

fieldName est le nom du champ dans la base de données de projets. Utilisez uniquement des majuscules.

Une tentative d’obtention ou de définition de la valeur d’un champ non applicable aux exigences de ce type provoque une exception.

FieldMultiValue

R/W Objet

Objet MultiValue du champ spécifié. Voir Objet MultiValue.

Syntaxe : Req.FieldMultiValue[fieldName]

fieldName est le nom du champ dans la base de données de projets. Utilisez uniquement des majuscules.

HasAttachment

R Booléen

Vérifie si l’objet possède une ou plusieurs pièces jointes.

HasCoverage

R Booléen

L’exigence est couverte par au moins un test.

HasLinkage

R Booléen

Vérifie si au moins un bug a été associé à l’objet actuel.

HasRichContent

R Booléen

Vérifie si l’objet inclut un contenu riche.

ID

R Nombre

ID de l’élément.

IsLocked

R Booléen

Vérifie si l’objet est verrouillé pour l’édition.

IsLocked est défini par la méthode LockObject et est réinitialisé par la méthode UnlockObject.

Si l’objet possède une propriété AutoUnlock et que la propriété est définie sur True, IsLocked est également réinitialisé par une opération de publication ou d’actualisation.

Modifiée

R Booléen

Vérifie si l’élément a été modifié depuis la dernière actualisation ou opération de publication. Si cette valeur est true, les propriétés du champ côté serveur ne sont pas à jour.

Name

R/W Chaîne

Nom de l’exigence tel qu’il apparaît dans l’arborescence.

ParentId

R/W Nombre

ID de parent de l’exigence.

Définissez cette propriété pour placer l’exigence sous une autre exigence dans la hiérarchie.

La valeur par défaut est -1, ce qui indique une exigence de niveau supérieur.

Priorité

R/W Chaîne

Priorité de l’exigence.

Produit

R/W Chaîne

Nom du produit pour lequel l’exigence est définie.

ReqCoverageFactory R Objet Obtient un objet de fabrique ReqCoverage. Voir Objet ReqCoverageFactory.
RequirementType R Objet Obtient les types d’exigence. Voir Objet ReqType.

Examiné

R/W Chaîne

Statut de l’examen.

Le statut de l’examen peut être n’importe quelle valeur configurée dans le projet. Exemples généraux : Modifié, Non examiné et Examiné.

RnDEstimatedEffortInHours

R/W Nombre

Effort de recherche et développement.

Statut

R Chaîne

Statut des tests qui couvrent cette exigence.

Les statuts de ces tests sont les suivants : Échec, Pas exécuté, Non terminé ou Succès.

Si aucun test ne couvre cette exigence, la valeur est Non couvert.

Il peut également s’agir de n’importe quel statut personnalisé défini par l’administrateur de votre projet.

Type R/W Chaîne Nom du type d’exigence.

TypeId

R/W Chaîne

ID du type d’exigence.

TypeName

R Chaîne

Type du champ.

Virtual

R Booléen

Vérifie s’il s’agit d’un élément virtuel, c’est-à-dire d’un élément qui n’a pas d’enregistrement de base de données correspondant.

Exemple

Exemple : Déplacer des exigences

Exemple : Obtenir les tests de couverture non exécutés

Retour en haut