Créer un projet

Créer un projet est la première étape pour commencer à travailler avec IBM® DevOps Test Integrations and APIs (Test Integrations and APIs). Un projet contient les paramètres de base utilisés par les tests. Vous pouvez également trouver différents guides interactifs sur la page d'accueil qui vous fournissent des informations sur les tâches courantes que vous pouvez accomplir dans Test Integrations and APIs.
  • Tu as dû fermer IBM DevOps Test Virtualization Control Panel (Test Virtualization Control Panel) sessions en cours, le cas échéant.
  • Si Test Integrations and APIs est en cours d'exécution et vous venez de terminer les tâches dans Créer et exécuter un test, vous avez probablement ce projet ouvert. Pour créer et exécuter un stub avec un fichier WSDL, vous devez créer un nouveau projet. Par conséquent, vous devez fermer le projet existant en cliquant surFichier > Fermer le projet. Cette action ferme le projet et redémarre Test Integrations and APIs.

Après avoir redémarré Test Integrations and APIs, vous devez créer un nouveau projet, donner un nom à votre projet et l'enregistrer sur votre disque local. Les instructions suivantes s'appliquent aules fenêtres™ Système d'exploitation.

  1. Dans la fenêtre de démarrage, sélectionnez Créer un projet et cliquez D'ACCORD.
  2. Entrez un nom pour le projet dans le champ nom du projet champ.
  3. Cliquez sur Parcourir et sélectionnez un emplacement pour enregistrer le projet.

    Si vous ne parcourez pas et ne sélectionnez pas d'emplacement, le projet est enregistré dans l'emplacement par défaut, qui est votre répertoire personnel. Par exemple, l'emplacement par défaut estC:\Users\USER_ADMIN comme le montre l’image suivante.

    Image de la nouvelle fenêtre du projet.

  4. Cliquez sur Finition.
Le nouveau projet est créé.

Vous devez démarrer le serveur et le client Add Numbers. Voir Démarrage du serveur et du client Add Numbers.

Démarrage du serveur et du client Add Numbers

Vous pouvez le faire en utilisant les exemples de documents WSDL tels que le serveur et le client Add Numbers fournis avec Test Integrations and APIs, exécutez les scripts dans le cadre de votre projet et testez l'utilisation d'un service Web hébergé sur votre système local.

Vous devez avoir créé un projet comme décrit dans Créer un projet. Votre projet doit être ouvert dans Test Integrations and APIs.

Test Integrations and APIs contient quelques exemples d'API. Dans cet exemple, vous utilisezAddNumbers, qui contient un document WSDL décrivant l'API.

Si vous souhaitez modéliser un système qui n'a pas de définition WSDL, vous pouvez utiliser un fichier Swagger (que vous avez complété dans Créer et exécuter un test ) ou vous pouvez découvrir et enregistrer une API (que vous pouvez compléter comme décrit dans Découverte, enregistrement et interception d'un proxy HTTP ).

  1. Dans le lecteur local, accédez à <install_location>/DevOpsTestAPI/examples/addnumbers.
  2. Exécutez lestartup scénario.

    Le Ajouter un serveur de numéros la fenêtre s’affiche.

  3. Cliquez sur Démarrer le service.

    Cette action démarre le service Web Ajouter des numéros sur l'hôte.

    Prenez note du Adresse de l'hôte et Numéro de port des champs. Vous en aurez besoin dans les prochaines étapes.

    Image de la fenêtre du serveur Ajouter des numéros.

  4. Dans le lecteur local, accédez à <install_location>/DevOpsTestAPI/examples/addnumbersclient.
  5. Exécutez le script de démarrage.
    Note:
    Assurez-vous que les champs d'hôte et de port correspondent aux valeurs que vous avez notées précédemment dans le Ajouter un serveur de numéros fenêtre.
  6. Clique le égal signe.

    L'application client envoie une requête HTTP SOAP à l'application serveur, qui additionne les deux nombres et renvoie le résultat. Vous pouvez voir le résultat sur Ajouter un client de numéros fenêtre. Il s'agit d'une API simple et facile à comprendre pour vous aider à démarrer la création d'un stub.

    Image de la fenêtre Ajouter un client Numbers.

Vous avez testé avec succès un service Web hébergé sur votre système local à l'aide de l'exemple WSDL.

Vous devez importer le fichier WSDL. Voir Importer leAdd Numbers le fichier WSDL du serveur pour modéliser son API.

Importer leAdd Numbers le fichier WSDL du serveur pour modéliser son API

Vous pouvez modéliser l'API du WSDL à partir de la vue logique dans Test Integrations and APIs en utilisant l'exemple WSDL fourni avec Test Integrations and APIs comme sous-tâche de création et d'exécution d'un stub.

Vous devez avoir terminé le test du service Web à l'aide de l'exemple de fichier WSDL.

  1. Retour au Ajouter un serveur de numéros fenêtre. Sélectionnez l'URL WSDL affichée dans le champ WSDL ( http://localhost:8088/addNumbers?wsdl ) et appuyez sur Ctrl+C pour le copier.
  2. Retour au Test Integrations and APIs fenêtre. Dans la barre d'outils, cliquez sur École d'architecture, puis cliquez sur Vue logique pour visualiser le canevas sur lequel vous allez modéliser le système.
  3. Collez l'URL sur le canevas en cliquant surModifier > Pâte. Alternativement, dans la fenêtre Source de synchronisation, cliquez sur Nouveau. Dans le Sélectionnez l'emplacement boîte de dialogue, collez l'URL dans le Emplacement champ et cliquez sur D'ACCORD.

    Image de la fenêtre Créer une nouvelle source de synchronisation.

  4. Cliquez sur Suivant.

Test Integrations and APIs crée des composants de service et des opérations sur le canevas pour représenter le service décrit dans le fichier WSDL. Les options de création de tests et de stubs à partir de la définition de service sont également affichées. Vous avez déjà utilisé ces options pour créer et exécuter un test dans Créer et exécuter un test.

Vous devez créer un stub à partir de la définition WSDL. Voir Création d'un stub à partir de la définition WSDL de l'API.

Création d'un stub à partir de la définition WSDL de l'API

Vous pouvez créer un stub à partir de la définition WSDL de l'API dans Test Integrations and APIs en utilisant l'exemple WSDL fourni avec Test Integrations and APIs comme sous-tâche de création et d'exécution d'un stub.

Vous devez avoir terminé l'importation du WSDL dans Test Integrations and APIs.

  1. Dans le Générer des actifs pour les opérations la page du Créer une nouvelle source de synchronisation fenêtre, sélectionnez le additionStub case à cocher dans le Créer des talons colonne.

    Cette action crée un stub pour l'opération basé sur l'interface définie dans le fichier WSDL.

    Image de la fenêtre Créer une nouvelle source de synchronisation.

  2. Cliquez sur Suivant.

    Le Résumé La page affiche le nombre d'éléments créés.

  3. Cliquez sur Finition.

    Le stub est ouvert dans la perspective Test Factory, qui est utilisée pour créer et modifier des tests et des stubs.

    Par défaut, l'onglet Événements de l'éditeur de stub est ouvert et affiche les événements que le stub peut gérer. Dans ce cas, il n’y a qu’un seul événement pour l’opération d’addition. Il y a deux sous-onglets sous le Événements onglet intitulé Saisir et Activité. Lorsqu'un événement est sélectionné, le Saisir affiche le message qui devrait être reçu par le stub et qui est géré par l'événement sélectionné.

    Image montrant l'onglet Événements du stub.

    Le stub a la structure du message SOAP que leaddNumbers l’opération d’addition attend en entrée. Dans le Activité, vous pouvez configurer la réponse envoyée ou d'autres actions prises lorsque le stub reçoit une demande qui correspond aux données du Saisir languette. Les deux Activité l'onglet et le Saisir L'onglet contient la structure du document, mais pas encore de données.

    Image montrant l'onglet Activité.

    Sur le Activité onglet, les deux derniers nœuds de l'arborescence appelée sont appelés retour (élément) (un élément XML appelé return ) et ( Texte ) (le contenu textuel de cet élément).

  4. Adjacent au ( Texte ), double-cliquez sur la cellule vide dans le Valeur colonne du tableau. Entrez le chiffre 100 et appuyez sur Entrer. Il s'agit de vérifier si c'est le stub qui renvoie le résultat en l'absence du serveur Add Numbers.

    Image de la fenêtre Ajouter des numéros Client.

  5. Enregistrez le talon.

Vous avez créé avec succès un stub à partir de la définition WSDL pour l'API.

Vous devez exécuter le stub créé. Voir Exécuter le stub.

Exécuter le stub

Vous devez exécuter le stub que vous avez créé à partir du fichier WSDL importé pour l'API en tant que sous-tâche de création et d'exécution d'un stub.
Vous devez avoir créé le stub à partir de la définition WSDL pour l'API.
  1. Dans la barre d'outils, cliquez sur Courir ou appuyez sur F5.

    Cette action exécute le stub dans le Laboratoire d'essais perspective.

    Image du journal de la console.

  2. Retour au Ajouter un client de numéros fenêtre.
  3. Clique le égal signe.

    Le résultat est la même réponse que précédemment, c'est-à-dire133 car le client n'a pas encore été configuré pour utiliser le stub.

Vous avez exécuté avec succès le stub créé.

Vous devez configurer le client pour utiliser le stub créé. Voir Configuration du client Add Numbers pour utiliser le stub (service virtuel).

Configuration du client Add Numbers pour utiliser le stub (service virtuel)

Vous pouvez configurer le client pour utiliser le stub créé comme service virtuel.

Vous devez avoir terminé la création du stub et l'exécuter.

Soutenir Test Integrations and APIs Service Virtualization, vous devez configurer les clients HTTP pour utiliser le Test Integrations and APIs Proxy HTTP/TCP. Les détails sur l'utilisation de ce proxy sont dans Découverte, enregistrement et interception d'un proxy HTTP.

Vous configurez le client Add Numbers pour utiliser le Test Integrations and APIs proxy en utilisant les paramètres de proxy Java standard.

Note:
Hormis le numéro de port, il n'y a rien de spécifique dans les paramètres proxy de Test Integrations and APIs. Toute application qui envoie son trafic via des proxys HTTP standard peut virtualiser ses dépendances HTTP à l'aide de l'outil Test Integrations and APIs Proxy HTTP/TCP.
  1. Fermer la Ajouter un client de numéros fenêtre.
  2. Ouvrez le script de démarrage situé àC:\Program Files\IBM\DevOpsTestAPI/examples/addnumbersclient dans un éditeur de texte.
  3. Modifiez le script comme suit:
    • Sous Windows:
      1. Commentez la ligne %JAVA_HOME%\bin\java %NET_PROPS% %SSL_PROPS% -jar AddNumbersClient.jar en insérant @rem au début.

        L'entrée modifiée apparaît comme: @rem %JAVA_HOME%\bin\java %NET_PROPS% %SSL_PROPS% -jar AddNumbersClient.jar.

      2. Décommentez la ligne de connexion à un proxy comme indiqué par les autres commentaires du fichier. Assurez-vous que cette ligne inclut le –Dhttp.proxyHost=localhost et -Dhttp.proxyPort=3128 arguments, qui indiquent à l'application d'utiliser le proxy démarré par Test Integrations and APIs, celui qui s'exécute localement sur le port 3128.
    • Sous Linux:
      1. Commentez la ligne $_RUNJAVA" "${SSL[@]}" -jar "$_SCRIPTDIR/AddNumbersClient.jar.
      2. Décommentez la ligne de connexion à un proxy, comme l'indiquent les autres commentaires du fichier. Assurez-vous que cette ligne inclut les arguments -Dhttp.proxyHost=localhost et -Dhttp.proxyPort=3128, qui ordonne à l'application d'utiliser le proxy démarré par Test Integrations and APIs, celui qui s'exécute localement sur le port 3128.
  4. Enregistrez et fermez le fichier.

Vous avez configuré avec succès le client Add Numbers pour utiliser le stub.

Vous devez appeler le talon. Voir Appeler le stub.

Appeler le stub

Vous pouvez appeler le stub au lieu de demander au serveur Add Numbers. Cette méthode est utile lorsque vous testez l'application client et si le serveur est indisponible ou est encore en cours de développement.

Vous devez avoir terminé la configuration du client Add Numbers pour utiliser le stub.

  1. Ouvrez le Laboratoire d'essais affichez et vérifiez que le stub est toujours en cours d’exécution.

    L'état du stub affiché dans le Moniteur de tâches Doit lireReady. S'il litCanceled, exécutez à nouveau le stub.

  2. Ouvrez le client Add Numbers en exécutant lestartup script situé àC:\Program Files\IBM\DevOpsTestAPI/examples/addnumbersclient.

    image du journal de la console.

  3. Clique le égal signe.

    Le client revient100 au lieu de la bonne réponse car il s'agit du numéro que vous avez configuré dans le stub lorsque vous l'avez créé dans Création d'un stub à partir de la définition WSDL de l'API.

    image de la fenêtre Ajouter des numéros Client.

    Au lieu d'appeler le serveur Add Numbers, la requête obtient la réponse du stub, ce qui vous donne un contrôle total sur les réponses que le client reçoit à ses requêtes, par exemple lors du test des cas d'erreur.
    Important:
    Dans Test Integrations and APIs, les stubs cessent de s'exécuter après une durée spécifique. Si le résultat renvoyé par le client Add Numbers est133, c'est-à-dire la valeur réelle renvoyée par le serveur Add Numbers, revenez à Test Integrations and APIs et assurez-vous que le stub est toujours en cours d’exécution. Pour les tests qui nécessitent des stubs exécutés en continu, vous devez les déployer et les exécuter dans Test Virtualization.
  4. Optional: Pour que le client Add Numbers reçoive à nouveau sa réponse du serveur Add Numbers, procédez comme suit:
    1. Retour au Test Integrations and APIs et veiller à ce que Laboratoire d'essais est ouvert. Si ce n'est pas le cas, cliquez Laboratoire d'essais sur la barre d'outils pour l'ouvrir.
    2. Arrêtez le talon. Effectuez cette action en sélectionnant le stub en cours d'exécution dans le Moniteur de tâches tableau et en cliquant Arrêt icône dans la barre d'outils.
    3. Clique le égal connectez-vous dans la fenêtre du client Add Numbers.
      Cette action permet à l'application client de recevoir à nouveau sa réponse du serveur Add Numbers, même si elle est toujours configurée pour utiliser le proxy HTTP.
  • Pour modéliser votre système lorsque vous ne disposez pas de définition Swagger ou de fichiers WSDL et pour plus de détails sur le proxy HTTP/TCP, voir Découverte, enregistrement et interception d'un proxy HTTP.
  • Pour une autre procédure de création d'un stub pour l'API Add Numbers, cliquez sur la vignette intitulée Créer un service Web virtualisé sur le Test Integrations and APIs Écran d'accueil. Cela ouvre un guide interactif interne qui vous guide dans la création d'un stub pour le serveur Add Numbers.
  • Pour créer des stubs supplémentaires pour l'opération d'ajout, procédez comme suit:
    1. Ouvrez le Perspective Test Factory dans Test Integrations and APIs.
    2. Dans l'arborescence de gauche, faites un clic droit sur l'opération d'ajout et cliquez surNouveau > Talons > Stub utilisant MEP. Cette action crée un stub pour l'opération et un événement en utilisant Modèle d'échange de messages de l'opération importée à partir du fichier WSDL.
    3. Pour créer des stubs à partir des données de vos systèmes réels plutôt que de saisir les données manuellement, vous pouvez enregistrer le trafic dans le système testé et créer des stubs à partir de ces enregistrements. Pour obtenir des instructions sur la façon d'enregistrer le trafic pour créer des stubs, voir Découverte, enregistrement et interception d'un proxy HTTP. Vous pouvez également utiliser l'enregistrement en combinaison avec une définition WSDL ou Swagger pour modéliser le système testé. En d'autres termes, créez les composants de service, les ressources de transport et les opérations en les synchronisant avec WSDL ou Swagger, puis enregistrez le trafic pour créer des tests et des stubs.