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.

  • 🎯 Definition: Reporter.ReportEvent skriver en brugerdefineret status og besked ind i UFT Resultattræ, uafhængigt af indbyggede kontrolpunkter.
  • 🧩 Syntaks: Metoden tager EventStatus, ReportStepName, Details og en valgfri ImageFilePath i nævnte rækkefølge.
  • 🚦 Statuskonstanter: micPass, micFail, micDone og micWarning angiver hver især trinfarven og om kørselsstatussen ændres.
  • ️ Screenshots: Send en optaget bitmap-sti som det fjerde argument for at vedhæfte et billede til et fejlagtigt trin.
  • 🇧🇷 egenskaber: Reporter.Filter, Reporter.ReportPath og Reporter.RunStatus tilføjer kontrol over, hvad der logges, og hvor resultaterne gemmes.
  • 🧪 eksempler: Pak ReportEvent ind i en If…Then-kontrol, så hvert trin rapporterer bestået eller fejlet ud fra det reelle resultat.
  • 🚫 filtrering: Indstil Reporter.Filter til rfEnableErrorsAndWarnings under CI-kørsler, så gennemførte trin ikke skjuler ægte fejl.
  • 📊 Tilpassede rapporter: Kombiner results.xml med et XSL- eller et VBScript-bibliotek for at præsentere resultaterne på den måde, interessenterne forventer.

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.

Ofte Stillede Spørgsmål

ReportEvent skriver almindelig tekst til resultattræet. ReportHTMLEvent, tilgængelig siden UFT 12.52 accepterer HTML i trinnavnet og detaljerne, så du kan fremhæve, farvelægge eller formatere tekst i Run Results Viewer.

Nej. Kun micFail ændrer den samlede kørselsstatus til Fail. Både micDone og micWarning skriver et trin til resultattræet til information, men testen kan stadig afsluttes som Bestået, selvom der blev logget advarsler.

Ja. Optag et bitmap med et objekts CaptureBitmap-metode, gem det i en fil, og send den filsti som det valgfrie fjerde ImageFilePath-argument. UFT viser billedet i ruden Optagne data for det pågældende trin.

Ja. AI-kodningsassistenter kan generere standardbeskrivelserne If…Then og ReportEvent ud fra en letforståelig beskrivelse af en kontrol og kan markere scripts, der misbruger micFail eller springer detaljer over. En tester bør stadig bekræfte, at den loggede status matcher det faktiske resultat.

AI-drevne observationsværktøjer kan opsummere en kørsel og fremhæve anomalier automatisk, men Reporter.ReportEvent giver stadig de præcise, udviklerstyrede trinnavne og statusser, der fodrer disse værktøjer. De fleste teams bruger begge sammen i stedet for at erstatte det ene med det andet.

Opsummer dette indlæg med: