Comment utiliser les fonctions dans QTP/UFT en 3 Easy Steps

Par : Thomas Hamilton Thomas Hamilton
Hours Le kit de préparation mis à jour

⚡ Résumé intelligent

Fonctions dans QTP/UFT Permettre aux testeurs d'intégrer une logique VBScript réutilisable dans des fichiers de bibliothèque que n'importe quel test peut appeler, réduisant ainsi la duplication, simplifiant la maintenance et accélérant le développement de l'automatisation. UFT et QTP projets.

  • 📚 Définition: Une bibliothèque de fonctions est un fichier .qfl ou .vbs contenant des fonctions VBScript réutilisables. UFT Le test peut appeler.
  • ️ Création: Créez une bibliothèque à partir de Fichier > Nouveau > Bibliothèque de fonctions et écrivez-y des blocs Fonction…Fin de fonction VBScript standard.
  • 🔗 Association: Attachez la bibliothèque via Fichier > Paramètres > Ressources > Associer une bibliothèque de fonctions pour exposer ses fonctions au test.
  • ▶ ️ Appel: Invoquer une fonction de bibliothèque par typing son nom avec des arguments à l'intérieur du script de test, exactement comme une fonction intégrée UFT déclaration.
  • 🇧🇷 Formats de fichier: Choisissez .qfl pour le format natif UFT éditeur ou .vbs pour un fichier texte brut lisible partout, y compris dans un système de contrôle de version.
  • ⚙️ Chargement en cours d'exécution : Utilisez LoadFunctionLibrary ou ExecuteFile pour attacher une bibliothèque par programmation au lieu de la boîte de dialogue Ressources.
  • 🧭 Discipline de dénomination : Donnez à chaque fonction un nom unique dans toutes les bibliothèques associées, car UFT Exécute la dernière définition chargée en cas de conflit de noms.
  • (I.e. Reporting: Remplacer le messageBox Les appels avec Reporter.ReportEvent permettent aux statuts de réussite, d'échec et d'avertissement d'apparaître directement dans le UFT Arbre de résultats.
En savoir plus

Si vous avez des segments de code que vous devez utiliser plusieurs fois dans vos tests, vous pouvez créer une fonction personnalisée. Les fonctions personnalisées permettent de raccourcir vos tests et de les rendre plus faciles à concevoir, à lire et à maintenir.

Vos propres bibliothèques de fonctions dans Micro Focus UFT peut contenir VBScript fonctions, sous-programmes, modules, etc.

Il vous suffit de suivre 3 étapes simples pour utiliser une fonction d'une bibliothèque dans votre test.

Une bibliothèque de fonctions diffère d'une action in UFT: une fonction ne possède pas de référentiel d'objets ni de fiche technique propre, pourtant toute action ou tout test peut l'appeler une fois la bibliothèque associée.

Copier-coller les mêmes étapes dans chaque action multiplie les tâches de maintenance, car la moindre modification doit alors être répétée pour chaque copie. Une bibliothèque de fonctions résout ce problème en centralisant cette logique dans un endroit unique, accessible à toute action ou test du projet.

3 étapes simples pour utiliser une fonction d'une bibliothèque dans UFT/QTP

Étape 1) Créez une nouvelle bibliothèque de fonctions dans UFT or QTP en sélectionnant Fichier > Nouveau > Bibliothèque de fonctions. Elle s'ouvre dans un nouvel onglet. QTP.

Créons une fonction très simple qui affiche une boîte de message.

Function Demo

MsgBox "This is a Test Function"

End Function

Chaque fois que cette fonction est appelée, une boîte de message s'affiche. Un seul fichier peut contenir plusieurs fonctions ; il est donc conseillé de l'enregistrer une seule fois et de le réutiliser pour de nombreux tests. UFT enregistre une bibliothèque de fonctions avec un .qfl extension par défaut, bien qu'il s'agisse d'une simple .vbs Le fichier fonctionne également, comme l'explique la section suivante.

Étape 2) Associez la bibliothèque à votre test. Ouvrez Fichier > Paramètres > Ressources > Associer une bibliothèque de fonctions, puis cliquez sur Ajouter, sélectionnez le fichier de bibliothèque de fonctions, puis cliquez OK.

Étape 3) La dernière étape consiste à appeler la fonction dans le script de test. Une fois la bibliothèque associée, appeler une fonction est aussi simple que d'écrireping son nom et le passage des arguments requis, comme indiqué ci-dessous.

' Call the function from the associated library
Demo()

UFT localise Demo dans la bibliothèque associée et l'exécute exactement comme si elle était écrite localement à l'intérieur du test.

Remarques importantes

  • Grâce aux objets COM et DCOM, vous pouvez créer des fonctions très avancées.
  • En fait, bon nombre des fonctionnalités offertes par QTP peut être codé en utilisant VBScript
  • Nous avons vu des ingénieurs en automation qui en font davantage un projet VB plutôt qu'un projet d'automatisation.
  • Notre recommandation est de se concentrer sur l’automatisation à 100 % plutôt que d’afficher vos compétences en VB.

Cliquez à nouveau ici si la vidéo n'est pas accessible

Types de fichiers de bibliothèque de fonctions : .qfl ou .vbs

UFT n'impose pas de format de fichier unique pour une bibliothèque de fonctions. L'éditeur de bibliothèque de fonctions enregistre les nouveaux fichiers avec un format spécifique. .qfl extension par défaut, et UFT accepte également un texte brut .vbs fichier créé dans n'importe quel éditeur de code, car un QTP/UFT Une bibliothèque de fonctions n'est rien d'autre qu'un script VBScript ordinaire stocké sur disque ; les deux formats se comportent de manière identique lors de l'exécution.

VOLET FICHIER .QFL FICHIER .VBS
Créé avec UFT Éditeur de bibliothèque de fonctions Tout éditeur de texte ou de code
S'ouvre à l'extérieur UFT Non Oui, en texte brut
convivialité du contrôle de version Édition Mieux, car les différences sont lisibles.
Méthode d'association Pareil pour les deux Pareil pour les deux

Le choix dépend surtout du flux de travail de l'équipe plutôt que des fonctionnalités. Une bibliothèque ponctuelle construite rapidement en interne UFT fonctionne parfaitement .qfl, tandis que les bibliothèques maintenues dans Git, SVN ou un autre système de contrôle de version sont généralement conservées comme .vbs Les fichiers sont préférables car le texte brut permet de comparer le code de manière beaucoup plus lisible lors des revues de code. Les deux formats prennent en charge l'ensemble des fonctionnalités de VBScript, y compris les classes, la gestion des erreurs et la création d'objets COM, et s'associent à un test de la même manière, comme l'explique la section suivante.

Renommer l'extension d'un fichier ne modifie pas son contenu. Par conséquent, convertir un fichier existant .qfl déposer à .vbs, ou inversement, consiste simplement à renommer un fichier puis à réassocier le fichier renommé au test.

ARTICLES LIÉS

Méthodes pour associer une bibliothèque de fonctions à un test

L'étape 2 ci-dessus utilise la boîte de dialogue Ressources, mais UFT Il existe en réalité plusieurs façons d'associer une bibliothèque de fonctions à un test, et le choix de la méthode appropriée dépend du caractère permanent ou temporaire de cette association. Un test peut être associé à plusieurs bibliothèques simultanément. UFT les charge dans l'ordre où ils apparaissent dans la liste des ressources.

  1. Boîte de dialogue Associer une bibliothèque de fonctions (interface graphique) : Ouvrez Fichier > Paramètres > Ressources > Associer une bibliothèque de fonctions, cliquez sur Ajouter et sélectionnez le fichier. UFT Cette association est stockée au sein même du test, de sorte que la bibliothèque se charge automatiquement à chaque ouverture du test. C'est la méthode présentée à l'étape 2 ci-dessus et elle constitue un excellent choix par défaut pour toute bibliothèque requise par tous les tests d'un projet.
  2. instruction LoadFunctionLibrary : Appelez la fonction LoadFunctionLibrary « chemin » depuis l'intérieur d'un script pour attacher une bibliothèque lors de l'exécution sans avoir à modifier la boîte de dialogue Ressources. UFT traite la bibliothèque exactement comme une association basée sur un dialogue pour le reste de cette exécution, ce qui est pratique lorsque le chemin d'accès à la bibliothèque est décidé dynamiquement.
  3. Instruction ExecuteFile : ExecuteFile « chemin » exécute un fichier de script et expose ses fonctions à l'exécution en cours, mais UFT ne pas enregistrer le fichier comme un tracRessource ked, elle n'apparaît donc jamais sous Bibliothèques de fonctions associées dans les paramètres de test.
  4. Modèle d'objet d'automatisation (AOM) : Un fichier VBScript externe peut lancer UFTOuvrez un test et ajoutez une bibliothèque à Test.Settings.Resources.Libraries par programmation. Les scripts de compilation ou de déploiement utilisent généralement cette approche pour configurer la même bibliothèque pour des dizaines de tests en une seule passe.
' Load a library at run time from inside a script
LoadFunctionLibrary "C:\Automation\CommonFunctions.qfl"

' ExecuteFile works the same way, but UFT does not
' track the file as an associated resource
ExecuteFile "C:\Automation\CommonFunctions.qfl"

Quelle que soit la méthode choisie, une bibliothèque ne doit être associée qu'une seule fois par test pour les méthodes GUI et AOM, tandis que LoadFunctionLibrary et ExecuteFile doivent être exécutées à nouveau à chaque exécution du script, car il s'agit d'instructions VBScript ordinaires et non de paramètres enregistrés.

Lorsqu'une bibliothèque n'est plus nécessaire, supprimez-la de la liste des ressources plutôt que de la laisser associée, car une bibliothèque inutilisée peut toujours masquer une fonction portant le même nom que vous ajouterez ultérieurement à une autre bibliothèque.

Meilleures pratiques pour l'écriture UFT/QTP Bibliothèques de fonctions

Une bibliothèque de fonctions n'est rentable que si toute l'équipe peut lui faire confiance et la maintenir. Les bonnes pratiques suivantes permettent de garantir la fiabilité d'une bibliothèque à mesure qu'elle évolue.

  • Utiliser Option Explicit : Ajoutez-le comme première ligne de chaque bibliothèque. UFT signale une variable mal orthographiée au lieu d'en créer silencieusement une nouvelle.
  • Veillez à ce que les noms de fonctions soient uniques : Si deux bibliothèques associées définissent une fonction portant le même nom, UFT appelle le dernier élément chargé, donc les noms en double entraînent des erreurs silencieuses et difficiles à résoudre.tracet les insectes.
  • Renvoyer les valeurs au lieu de les coder en dur : Accepter des paramètres et renvoyer un résultat, comme dans l'exemple ci-dessous, afin que la même fonction serve à plusieurs tests au lieu d'un seul.
  • Évitez les messagesBox dans les scripts de production : Une boîte de dialogue suspend l'exécution jusqu'à ce que quelqu'un clique sur OK. Utilisez-la. Reporter.ReportEvent Ainsi, les statuts de réussite, d'échec et d'avertissement sont directement enregistrés dans l'arborescence des résultats, sans interruption.ping la course.
  • Regrouper par domaine, et non par commodité : Conservez les fonctions de connexion, les fonctions de base de données et les fonctions d'assistance à l'interface utilisateur dans des fichiers séparés afin que chaque test ne puisse associer que ce dont il a réellement besoin.
  • Maintenez les bibliothèques sous contrôle de version : Stockez les fichiers de bibliothèque de fonctions dans le même dépôt que le reste du projet d'automatisation afin qu'une restauration du projet annule également toute fonction partagée.
Function AddNumbers(ByVal num1, ByVal num2)
    AddNumbers = num1 + num2
End Function

Dim result
result = AddNumbers(10, 20)
Reporter.ReportEvent micPass, "Sum Calculation", "The result is " & result

Appliquer ces habitudes dès le début coûte peu cher, mais les intégrer ultérieurement dans une grande bibliothèque non gérée est beaucoup plus onéreux.

FAQ

Une fonction peut renvoyer une valeur à l'appelant, contrairement à une procédure. Utilisez une fonction lorsqu'un script a besoin d'un résultat, comme une valeur calculée ou un indicateur de réussite/échec, et une procédure pour une action autonome, comme cliquer sur un bouton.

UFT ne génère pas d'erreur. Il appelle silencieusement la dernière définition chargée, selon l'ordre d'apparition des bibliothèques dans les paramètres des ressources ; par conséquent, des noms identiques dans deux bibliothèques peuvent engendrer des confusions et des difficultés de compréhension.trace résultats.

Oui. Une fois que les deux bibliothèques sont associées au même test, UFT Elle charge toutes leurs fonctions dans un seul espace de noms partagé, de sorte que n'importe quelle fonction d'une bibliothèque peut appeler une fonction définie dans une autre.

Oui. Les assistants IA peuvent générer des fonctions VBScript à partir d'une description en langage clair des étapes requises, mais un testeur doit tout de même vérifier le code généré pour s'assurer de l'exactitude des références aux objets et de la gestion des erreurs avant utilisation.

Les outils d'IA peuvent traduire la logique VBScript en langages comme Python or Java comme une ébauche de départ, mais un ingénieur QA doit vérifier l'identification des objets et la logique métier, car la traduction automatique préserve rarement parfaitement les deux.

Résumez cet article avec :