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.

Assurez-vous que la ressource de base de données est correctement configurée dans la perspective de l'école d'architecture. Pour plus d'informations sur la configuration d'une ressource de base de données, voir Ressources, connexions et liaisons de base de données.

Vous devez passer 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 de test et les actions, voir Actions de test.

Important: La récupération des procédures stockées doit être activée dans le composant de base de données physique avant de pouvoir configurer les options dans l'action de test Procédure stockée. Pour plus d'informations, voir Configuration de la ressource de base de données physique.

Sélectionner le test

  1. Dans la perspective Rational Integration Tester Test Factory, double-cliquez sur le test où l'action Stored Procedure doit être ajoutée.
  2. Dans la fenêtre Éditeur de test, cliquez sur Général > Procédure stockée.
  3. Pour modifier l'action, double-cliquez sur l'action Procédure stockée.

    La boîte de dialogue Procédure stockée s'ouvre dans laquelle vous pouvez sélectionner la procédure stockée.

Sélectionner la procédure stockée

  1. Sélectionnez une ressource de base de données parmi les ressources disponibles dans le projet en cliquant sur Parcourir.

    La liste initiale des bases de données est dérivée des informations fournies dans la perspective de l'école d'architecture. Si l'opération pour laquelle vous créez un test dépend d'une base de données, cette base de données s'affiche dans la liste lorsque Obey References est défini sur Oui. Si vous souhaitez travailler avec une base de données sans lien de dépendance avec l'opération en cours, toutes les bases de données du projet peuvent être visualisées en définissant Obey References sur Non.


    Onglet Configuration d'appel de procédure stockée
  2. Affinez les procédures disponibles en sélectionnant un schéma, ou un catalogue ou un package si disponible.
  3. Sélectionnez la procédure ou la fonction à exécuter lorsque l'action de procédure stockée s'exécute.
  4. Pour les connexions à la base de données Oracle, si vous utilisez DBMS_OUTPUT.PUT_LINE() dans votre code de procédure stockée, spécifiez que sa sortie est envoyée à la console lorsque vous exécutez des tests en cochant la case Connecter DBMS_OUTPUT à la console.
  5. Pour récupérer les procédures uniquement à partir du schéma des utilisateurs (basé sur le nom d'utilisateur et le mot de passe fournis sous l'onglet Paramètres de la ressource de base de données physique), cliquez sur Utiliser le nom d'utilisateur de connexion case à cocher. Si vous avez utilisé des balises pour le nom d'utilisateur et le mot de passe lors de la configuration des paramètres de connexion à la base de données, vous pouvez facilement récupérer les procédures du schéma de chaque utilisateur.
    Tip: Si vous ne voyez pas les procédures que vous attendez, vérifiez les paramètres de connexion et les filtres de procédure stockée qui sont configurés sur la ressource de base de données physique.
  6. Pour analyser les ensembles de résultats implicites renvoyés par la procédure sélectionnée, cochez la case Analyser l'ensemble de résultats.
  7. Enregistrez 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 peut être judicieux de tester la procédure.

  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 sont affichés et toutes les données renvoyées sont affichées 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 de modifier les exemples d'ensembles de résultats renvoyés par la procédure stockée, cliquez sur Fermer pour revenir à la boîte de dialogue Procédure stockée sans copier les résultats. Pour configurer les exemples de résultats, cliquez sur Remplacer le résultat attendu pour copier les résultats dans l'onglet Assert de la boîte de dialogue Procédure stockée. Ces données sont les données qui sont comparées à la procédure stockée lors de l'exécution du test.

    Onglet Assert de procédure stockée

Spécifier les entrées

Vous pouvez spécifier des valeurs ou des balises à fournir comme entrées à une procédure stockée.

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

    Avec l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action de Valeur, et la valeur est définie sur la valeur que vous souhaitez fournir comme entrée dans ce champ. Pour plus d'informations sur l'éditeur de champ, voir L'éditeur de champ.


    Onglet Valeur de procédure stockée
  3. Si vous fournissez des entrées différentes à chaque fois, désactivez la validation dans l'onglet Assert.

Spécifier les valeurs de retour attendues

Vous pouvez spécifier les valeurs de retour attendues de la procédure stockée. Par exemple, vous souhaiterez peut-être valider ce que chaque message de la structure de message renvoie.

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

    Avec l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action de Egalité, et la valeur est définie sur la valeur qui se trouve dans la base de données dans ce champ. Pour plus d'informations sur l'éditeur de champ, voir L'éditeur de champ.


    Onglet Validation de procédure stockée
  3. Le test échoue si la procédure stockée ne renvoie pas les valeurs attendues. Si vous souhaitez ignorer la validation d'une ligne, vous devez désactiver la case à cocher de validation Case à cocher de validation directement à sa droite.

Etiqueter les valeurs de retour

Vous pouvez baliser n'importe laquelle des valeurs de retour de la procédure stockée pour une utilisation ultérieure. Par exemple, vous pouvez définir la valeur des balises du test sur les valeurs de chaque colonne de la source de données.

  1. Cliquez sur l'onglet Store.
    Onglet Stored Procedure Store
  2. Tapez le nom d'une balise (nouvelle ou existante), ou cliquez avec le bouton droit sur le nom du champ et sélectionnez Contents > Quick Tag pour créer une balise de le même nom ou faites un clic droit sur le nom du champ et sélectionnez Contenu > Modifier.

    Avec l'option de menu, l'éditeur de champ s'ouvre. Par défaut, la valeur est un Type d'action de Copier, et la balise est définie sur la valeur que vous avez définie pour la balise dans ce champ. Pour plus d'informations sur l'éditeur de champ, voir L'éditeur de champ.

    Éditeur de champs pour l'onglet Magasin

  3. Si vous attendez des valeurs différentes à chaque fois, désactivez la validation dans l'onglet Assert.