Ajout d'une action Procédure stockée à un test

L'action Procédure stockée exécute une procédure stockée sur la base de données sélectionnée. Lorsque vous ajoutez cette action, vous pouvez visualiser le code de la procédure stockée, indiquer les valeurs d'entrée, spécifier les valeurs de retour attendues ou étiqueter les valeurs de retour obtenues.

Vérifiez que la ressource Base de données est correctement configurée dans la perspective Ecole d'architecture. Pour plus d'informations sur la configuration d'une ressource Base de données, voir Ressources, connexions et liaisons de base de données.

Vous devez avoir un test. Pour plus d'informations sur la création de tests, voir Fabrique de tests. Les tests incluent des étapes et des actions. Pour plus d'informations sur les étapes et les actions d'un test, voir Actions de test.

Important : Pour pouvoir configurer les options dans l'action de test Procédure stockée, vous devez d'abord activer la récupération des procédures stockées dans le composant Base de données physique. Pour plus d'informations, voir Configuration de la ressource de base de données physique.

Sélectionner le test

  1. Dans la perspective Fabrique de tests de Rational Integration Tester, double-cliquez sur le test auquel vous souhaitez ajouter une action Procédure stockée.
  2. Dans la fenêtre Editeur de test, cliquez sur Général > Procédure stockée.
  3. Pour éditer l'action, double-cliquez sur Procédure stockée.

    La boîte de dialogue Procédure stockée s'ouvre, vous permettant de sélectionner la procédure stockée.

Sélectionner la procédure stockée

  1. Cliquez sur Parcourir pour sélectionner une ressource Base de données parmi les ressources disponibles dans le projet.

    La liste initiale de bases de données est dérivée des informations fournies dans la perspective Ecole d'architecture. Si l'opération pour laquelle vous créez un test dépend d'une base de données, cette dernière est visible dans la liste lorsque l'option Obéir aux références est réglée sur Oui. Si vous voulez utiliser une base de données dont n'est pas tributaire l'opération courante, vous pouvez faire apparaître toutes les bases de données dans la liste en réglant l'option Obéir aux références sur Non.


    Onglet Configuration de l'appel de procédure stockée
  2. Limitez les procédures possibles en sélectionnant un schéma, un catalogue ou un package (si disponible).
  3. Sélectionnez la procédure ou la fonction à appeler et exécuter lorsque l'action Procédure stockée est exécutée.
  4. Pour les connexions à une base de données Oracle, si vous utilisez DBMS_OUTPUT.PUT_LINE() dans le code de votre procédure stockée, la sortie de cette dernière peut être envoyée à la console lors de l'exécution des tests. Pour cela, cochez la case Envoyer DBMS_OUPUT à la console.
  5. Cochez la case Utiliser le nom d'utilisateur de la connexion si vous voulez seulement récupérer les procédures du schéma de l'utilisateur (d'après la combinaison nom d'utilisateur/mot de passe fournie sous l'onglet Paramètres de la ressource Base de données physique). Si vous avez utilisé des étiquettes à la place du nom d'utilisateur et du mot de passe lorsque vous avez configuré la connexion à la base de données, vous pouvez facilement récupérer les procédures du schéma de chaque utilisateur.
    Conseil : Si vous ne voyez pas les procédures attendues, vérifiez les paramètres de connexion et les filtres de procédures stockées qui sont configurés sur la ressource Base de données physique.
  6. Pour interpréter les ensembles de résultats implicites renvoyés par la procédure sélectionnée, cochez la case Interpréter les ensembles de résultats.
  7. Sauvegardez l'action Procédure stockée en cliquant sur OK.

Tester la procédure stockée

Avant d'exécuter la procédure stockée sur une base de données sélectionnée, il est peut-être bon de la tester.

  1. Pour exécuter la procédure stockée et récupérer les données sans exécuter le test, cliquez sur Tester.

    Les résultats s'affichent et les données renvoyées apparaissent dans la boîte de dialogue Aperçu.


    Aperçu des résultats de la procédure stockée
  2. Pour ajouter manuellement des données au lieu d'adapter puis de copier les spécimens d'ensembles de résultats de la procédure stockée, cliquez sur Fermer afin de retourner à la boîte de dialogue Procédure stockée sans rien copier. Pour configurer les spécimens de résultats, cliquez sur Remplacer les résultats attendus afin de copier les résultats dans l'onglet Assertion de la boîte de dialogue Procédure stockée. Ces données sont celles qui sont comparées à la procédure stockée pendant l'exécution du test.

    Onglet Assertion de la procédure stockée

Spécifier les entrées

Vous pouvez spécifier des valeurs ou des étiquettes à fournir en entrée d'une procédure stockée.

  1. Cliquez sur l'onglet Valeur.
    Onglet Valeur de l'appel de procédure stockée
  2. Entrez les valeurs à fournir comme entrées de chaque message dans la structure de messages. Vous pouvez entrer une valeur directement dans la colonne Valeur ou bien cliquer avec le bouton droit de la souris dans le champ Valeur et sélectionner Contenu > Editer.

    Dans le cas de l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action Valeur et la valeur est celle que vous fournissez comme entrée de ce champ. Pour plus d'informations sur l'éditeur de zone, voir L'éditeur de champ.


    Onglet Valeur de l'appel de procédure stockée
  3. Si les entrées fournies sont différentes à chaque fois, désactivez la validation sous l'onglet Assertion.

Spécifier les valeurs de retour attendues

Vous pouvez spécifier les valeurs de retour attendues de la procédure stockée. Vous pourriez, par exemple, souhaiter valider ce que chaque message de la structure retourne.

  1. Cliquez sur l'onglet Assertion.
    Onglet Assertion de l'appel de procédure stockée
  2. Entrez une valeur pour chaque message dans la structure de messages. Vous pouvez entrer une valeur directement dans la colonne Valeur ou bien cliquer avec le bouton droit de la souris dans le champ Valeur et sélectionner Contenu > Editer.

    Dans le cas de l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action Egalité, et la valeur est paramétrée sur une valeur figurant dans la base de données dans cette zone. Pour plus d'informations sur l'éditeur de zone, voir L'éditeur de champ.


    Onglet Valider de l'appel de procédure stockée
  3. Le test échoue si la procédure stockée ne renvoie pas les valeurs attendues. Pour omettre la validation d'une ligne, décochez la case Case à cocher de validation à droite de cette ligne.

Etiqueter les valeurs de retour

Vous pouvez étiqueter les valeurs de retour de la procédure stockée en vue de les utiliser ultérieurement. Par exemple, vous pourriez souhaiter affecter les valeurs de chaque colonne de la source de données aux étiquettes du test.

  1. Cliquez sur l'onglet Stocker.
    Onglet Stocker de l'appel de procédure stockée
  2. Entrez le nom d'une étiquette (nouvelle ou existante) ou cliquez avec le bouton droit de la souris sur le nom du champ et sélectionnez Contenu > Etiquette rapide pour créer une étiquette du même nom ou Contenu > Editer pour ouvrir l'éditeur de champ.

    Dans le cas de l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action Copier et l'étiquette est celle que vous appliquez dans ce champ. Pour plus d'informations sur l'éditeur de zone, voir L'éditeur de champ.

    Onglet Stocker de l'éditeur de zone

  3. Si les valeurs attendues sont différentes à chaque fois, désactivez la validation sous l'onglet Assertion.