|
VADELIA |
|||
(B) (C) |
Attention : cet ordre s'utilise uniquement dans le cadre d'un programme de test unitaire VADELIA Batch généré en client Java.
Paragraphe d'utilisation
Procédure publique de test
Syntaxe
ASSERTION ValeurAttendue ValeurTestée Message
ou
ASSERTION *ECHEC Message
ValeurAttendue : Constante | IdVar | IdTableau | MotRéservé
ValeurTestée : Constante | IdVar | IdTableau | MotRéservé
Message : Constante alphanumérique | IdVar alphanumérique | rien
Description
Cet ordre s'utilise dans un programme de test unitaire et vérifie que la ValeurTestée est bien égale à la ValeurAttendue.
Si ce n'est pas le cas, le test échouera. L'exécution de la procédure de test sera arrêtée et un message d'erreur sera affiché dans le rapport de test. Si un Message (paramètre facultatif) est indiqué, son texte sera inclus dans le message d'erreur du rapport.
ValeurAttendue et ValeurTestée doivent être de même définition (même type et même longueur), et si ce sont des tableaux, ils doivent être de même dimension.
Dans le cas où ValeurAttendue est une constante, son type doit être compatible avec le type de la variable ValeurTestée.
Les variables ou tableaux utilisés doivent être un type Adélia simple (ALPHA, NUM_BIN_2, NUM_BIN_4,NUM_BIN_8, NUM_E, NUM_P, DATE, TIME, TIMESTAMP), à l'exception du type IMAGE qui n'est pas autorisé.
Les mots réservés suivants sont admis en ValeurAttendue : *OP_INVALIDE, *NON_TROUVE, *NORMAL, *BLANK, *HIVAL, *LOVAL, *NULL, *VRAI, *FAUX. Dès lors que ValeurAttendue correspond à un des ces mots réservés, un tableau n'est pas autorisé en ValeurTestée.
Les mots réservés suivants sont admis en ValeurTestée : *CODE_RETOUR, *BLOQUE, *SQLCODE, *SQLSTATE, *TROUVE, *SQLROWCOUNT.
L'exécution de l'ordre avec le paramètre *ECHEC fait systématiquement échouer le test, arrête l'exécution de la procédure, et provoque l'affichage d'un message d'erreur dans le rapport de test.
Si un Message (paramètre facultatif) est indiqué, son texte sera inclus dans le message d'erreur du rapport.
Par exemple
RES = 128
ASSERTION 128 RES 'est numéro 1'
--> Le test a réussi
RES_ALPHA = 'test en échec'
ASSERTION 'mon test' RES_ALPHA 'test numéro 2'
--> Le test va échouer
SI MaVariable < 100
WMESSAGE = 'La valeur '// &NUM_ALPHA(MaVariable) /// ' est trop petite'
ASSERTION *ECHEC WMESSAGE
FIN
ASSERTION *NORMAL *SQLCODE 'La requête SQL a échoué'
ASSERTION *HIVAL RES
ASSERTION 0 *CODE_RETOUR 'L'opération s'est terminée en erreur'