Reporter.RapporterHændelse i UFT/QTP med Eksempel
⚡ Smart opsummering
Reporter.RapporterHændelse i UFT/QTP sender brugerdefinerede beståede, mislykkede, advarsels- og informationsmeddelelser direkte til Run Results Viewer ved hjælp af statuskonstanterne micPass, micFail, micDone og micWarning, hvilket giver testere en læsbar, trinvis oversigt over, hvad et automatiseret script rent faktisk gjorde.

Hvad er Reporter.ReportEvent i UFT/QTP?
Reporter.ReportEvent er en standardmetode indbygget i UFT/QTP (sælges nu som OpenText/Mikrofokus UFT En) der skriver en brugerdefineret, menneskeligt læsbar besked direkte ind i testresultatvinduet. I modsætning til de automatiske beståelses- eller fejlvurderinger, som indbyggede kontrolpunkter genererer, lader et ReportEvent-kald testeren bestemme præcis, hvad der logges, hvornår og hvordan det skal mærkes.
Denne HP QTP tutorial demonstrerer brugen af funktionen Reporter.ReportEvent og ResultatformateringI vejledningen bliver du bedt om at oprette et kort script, og at gennemføre denne scriptøvelse er den hurtigste måde at se brugerdefineret rapportering opdatere resultattræet i realtid.
Klik link. hvis videoen ikke er tilgængelig
Reporter.ReportEvent er vigtigst i automatisering, fordi et script normalt kører uden opsyn, efter en tidsplan eller i en CI/CD-pipeline. Kørselsresultatfilen bliver den eneste registrering af, hvad der skete, så et trin, der fejler lydløst eller gennemføres uden forklaring, gør fejlfinding meget vanskeligere senere. Tilføjelse af et eksplicit ReportEvent-kald efter en kritisk handling forvandler resultattræet til et læsbart, trinvis revisionsspor, som en tester, udvikler eller leder kan gennemgå uden at åbne selve scriptet.
Dette er forskelligt fra et objektkontrolpunkt, som UFT genererer automatisk og rapporterer ved hjælp af sit eget standardtrinnavn. Reporter.ReportEvent giver dig i stedet mulighed for at tilføje forretningsmæssigt meningsfuldt sprog, såsom "Ordrebekræftelse vist" i stedet for et generisk "Check Point Pass på WebEdit-objekt", hvilket er langt lettere for en ikke-teknisk interessent at læse i den endelige rapport. Metoden fungerer på samme måde, uanset om scriptet er målrettet mod en webside, en Windows desktop-applikation eller en mainframe-terminal, da Reporter er et globalt objekt snarere end en egenskab for et enkelt testobjekt.
Guru99 s UFT/QTP serien dækker denne metode lige efter Hvis-, Ellers- og Eksisterer-sætninger, fordi de fleste Reporter.ReportEvent-kald sidder inde i en betinget blok, der afgør, om resultatet skal rapporteres som micPass eller micFail.
Reporter.ReportEvent-syntaks og EventStatus-værdier
Du kan bruge Reporter.ReportEvent at rapportere brugerdefinerede testtrin i Micro Focus UFTs testresultattræ. Metoden accepterer tre obligatoriske argumenter og et valgfrit argument i en fast rækkefølge, som vist nedenfor.
Reporter.ReportEvent EventStatus, ReportStepName, Details [, ImageFilePath]
Begivenhedsstatus angiver ikonet og farven, der vises for trinnet, og kan vende den samlede kørselsstatus; Rapporttrinnavn er den korte betegnelse, der vises i træet med testresultater, generelt skrevet som det forventede resultat; Detaljer indeholder den længere beskrivelse, typisk det faktisk observerede resultat; og den valgfrie Billedfilsti vedhæfter et skærmbillede taget tidligere i scriptet til det specifikke trin.
| VÆRDI | KONSTANT | EFFEKT PÅ RESULTATER | EFFEKT PÅ KØRSELSSTATUS |
|---|---|---|---|
| 0 | micPass | Trin vises som Bestået i resultattræet | Ingen ændring; testen fortsætter som bestået |
| 1 | mikrofonfejl | Trin vises som Fejl i resultattræet | Den samlede kørselsstatus ændres til Fejl |
| 2 | mikrofonFærdig | Trin vises som en informationsmeddelelse | Ingen ændring af status for bestået/ikke bestået |
| 3 | mikrofonAdvarsel | Trin vises som en advarsel | Ingen ændring af status for bestået/ikke bestået |
Hver konstant kan også sendes som sin numeriske værdi i stedet for sit navn, så Reporter.RapportHændelse 1, “Trin”, “Detalje” opfører sig præcis som Reporter.RapportHændelse micFail, “Trin”, “Detalje”Det er nemmere at læse den navngivne konstant i et script, som en anden tester vil vedligeholde senere.
Et script indlejrer typisk flere ReportEvent-kald i én handling: en micDone-post, før en handling starter, én micPass- eller micFail-post til nøglekontrollen og yderligere micWarning-poster for alt usædvanligt, der bemærkes undervejs.
- Når testcases udføres ved hjælp af automatiseringsværktøjer, kan det være svært for visse brugere at forstå de rå testresultater. Du kan bruge results.xml for at oprette en XSL-fil, der præsenterer testresultaterne, som du foretrækker det.
- Du kan også bruge vbscript biblioteksfunktioner til Gem resultaterne i en xls-fil eller en tekstfil til rapportering udenfor UFT.
Sådan bruger du Reporter.ReportEvent: Praktiske eksempler
Én ting er at kende syntaksen; at se den inde i et rigtigt script er det, der får de fire statuskonstanter til at klikke. Eksemplet nedenfor omslutter en check i en If…Then…Else-sætning og rapporterer derefter en bestået eller en fejlet med Reporter.ReportEvent, så resultatet vises i resultattræet præcis der, hvor en korrekturlæser forventer det.
If Browser("Guru99 Demo").Page("Guru99 Demo").WebButton("Login").Exist(5) Then Reporter.ReportEvent micPass, "Login button check", "Login button was found on the page" Else Reporter.ReportEvent micFail, "Login button check", "Login button was not found on the page" End If
Dette afspejler det mønster, der er vist i Guru99 s VBScript-betingede sætninger tutorial, hvor en If…Then…Else-blok vælger mellem to udfald; den eneste forskel her er, at hver gren også kalder Reporter.ReportEvent for at logge resultatet.
Brug mikrofonFærdig for et trin, der udelukkende er informativt, og mikrofonAdvarsel når noget ser usædvanligt ud, men ikke burde fejle kørslen fuldstændigt. Det næste kodestykke logger et dataindtastningstrin som Udført, markerer derefter et langsomt svar som en Advarsel og vedhæfter et skærmbillede ved hjælp af det valgfrie ImageFilePath-argument.
Reporter.ReportEvent micDone, "Enter search text", "Typed 'UFT tutorial' into the search box" errorImage = "C:\Results\SearchDelay.png" Browser("Guru99 Demo").CaptureBitmap errorImage, True Reporter.ReportEvent micWarning, "Search response time", "Results took longer than 5 seconds to load", errorImage
Holde Rapporttrinnavn kort og hold Detaljer specifikt om det faktiske resultat. En korrekturlæser, der scanner hundredvis af loggede trin efter en mislykket kørsel natten over, burde kunne se, hvad der skete, uden at åbne selve scriptet, og et ensartet navngivningsmønster på tværs af hver handling gør scanningen meget hurtigere.
Teams, der kalder ReportEvent fra mange scripts, flytter ofte denne logik til en delt VBScript-funktion, f.eks. LogStep(status, name, details), så hvert script producerer et ensartet resultattræ uden at gentage den samme If…Then-blok.
Egenskaber for Reporter-objekt: Filter, ReportPath og RunStatus
Reporter.ReportEvent er ikke det eneste medlem af Reporter-objektet. Tre yderligere egenskaber giver ekstra kontrol over, hvad resultaterne indeholder, og hvor UFT gemmer dem, og de dukker ofte op i produktionsautomatiseringsframeworks.
| EJENDOM | FORMÅL | TYPISK BRUG |
|---|---|---|
| Filtrer | Styrer hvilke hændelsestyper der skrives til resultaterne | Reporter.Filter = rfEnableErrorsAndWarnings skjuler gennemførte trin i en lang kørsel |
| Rapportsti | Skrivebeskyttet; returnerer den mappe, hvor resultaterne af den aktuelle kørsel er gemt | resultatmappe = Reporter.Rapportsti |
| Kørselsstatus | Skrivebeskyttet; returnerer den aktuelle status for bestået/ikke bestået for kørslen indtil videre | Hvis Reporter.RunStatus = micFail, så afslut handlingen |
Reporter.Filter accepterer fire værdier: 0 eller rfEnableAll viser alle hændelser og er standardværdien; 1 eller rfEnableErrorsAndWarnings skjuler gennemførte trin; 2 eller rfEnableErrorsOnly skjuler både gennemførte trin og advarsler; og 3 eller rfDisableAll deaktiverer resultatlogning helt. Hvis du markerer Reporter.RunStatus midt i et script, kan en test forgrene sin egen logik, for eksempel springe over.ping de resterende trin i en handling, når et tidligere trin allerede er mislykket.
Da ReportPath og RunStatus er skrivebeskyttede, kan du ikke tildele dem en værdi. Brug dem til at læse oplysninger om den aktuelle kørsel, for eksempel at skrive stien til resultatmappen til en logfil i starten af et script eller kortslutte en lang handling efter en fatal fejl. Læsning af disse egenskaber tilføjer ubetydelig overhead, så det er sikkert at kontrollere Reporter.RunStatus efter hvert større trin i en lang regressionssuite uden at forsinke kørslen på nogen mærkbar måde.
Bedste Practices for Reporter.ReportEvent in UFT
Et par vaner holder brugerdefineret rapportering nyttig i stedet for støjende.
- Reserver micFail til reelle fejl: Hvert micFail-kald vender Reporter.RunStatus, så brugen af det til kosmetiske problemer skjuler ægte defekter senere i samme kørsel.
- Skriv ReportStepName som et forventet resultat: En korrekturlæser bør forstå kontrollen alene ud fra trinnavnet, uden at læse kolonnen Detaljer.
- Tag kun skærmbilleder ved fejl: Hvis du sender ImageFilePath i hvert eneste trin, fylder det resultatmappen hurtigt og forsinker kørslen uden megen gavn.
- Filtrer støjende løb: Indstil Reporter.Filter til rfEnableErrorsAndWarnings for planlagte eller CI-kørsler, så gennemførte trin ikke skjuler de fejl, der er vigtige.
- Centraliser logikken: Ombryd Reporter.ReportEvent-kald i en genanvendelig Action eller funktionsbiblioteket, så alle scripts i suite-loggene resulterer på samme måde.
- Eksport til ikke-tekniske læsere: Kombinér results.xml med en brugerdefineret XSL, når interessenter uden for QA-teamet har brug for at gennemgå resultater uden at åbne UFT.
