Reporter.ReportEvent w UFT/QTP z Przykładem

⚡ Inteligentne podsumowanie

Reporter.ReportEvent w UFT/QTP wysyła niestandardowe komunikaty o zaliczeniu, niezaliczeniu, ostrzeżeniu i informacje bezpośrednio do przeglądarki Run Results Viewer, korzystając ze stałych statusu micPass, micFail, micDone i micWarning, zapewniając testerom czytelny, krok po kroku zapis tego, co faktycznie zrobił zautomatyzowany skrypt.

  • 🎯 Definicja: Reporter.ReportEvent zapisuje niestandardowy status i wiadomość do UFT Drzewo wyników, niezależne od wbudowanych punktów kontrolnych.
  • 🧩 Składnia: Metoda przyjmuje EventStatus, ReportStepName, Details oraz opcjonalnie ImageFilePath, w tej kolejności.
  • 🚦 Stałe statusu: micPass, micFail, micDone i micWarning ustawiają kolor kroku i określają, czy status przebiegu ma się zmieniać.
  • 🖼️ Screeny: Przekaż ścieżkę do przechwyconej mapy bitowej jako czwarty argument, aby dołączyć obraz do nieudanego kroku.
  • ⚙️ Charakterystyka: Reporter.Filter, Reporter.ReportPath i Reporter.RunStatus umożliwiają kontrolę nad tym, co jest rejestrowane i gdzie zapisywane są wyniki.
  • 🧪 Przykłady: Umieść ReportEvent wewnątrz If… Then i sprawdź, czy każdy krok raportuje wynik pozytywny lub negatywny na podstawie rzeczywistego wyniku.
  • ???? Filtracja: Ustaw Reporter.Filter na rfEnableErrorsAndWarnings podczas przebiegów CI, aby pominięte kroki nie ukrywały prawdziwych błędów.
  • 📊 Raporty niestandardowe: Połącz plik results.xml z biblioteką XSL lub VBScript, aby przedstawić wyniki w sposób oczekiwany przez interesariuszy.

Czym jest Reporter.ReportEvent w UFT/QTP?

Reporter.ReportEvent jest standardową metodą wbudowaną w UFT/QTP (obecnie sprzedawane jako OpenText/Mikro fokus UFT Jeden) zapisuje niestandardową, czytelną dla człowieka wiadomość bezpośrednio w oknie wyników testu. W przeciwieństwie do automatycznych werdyktów „zaliczony” lub „niezaliczony”, generowanych przez wbudowane punkty kontrolne, wywołanie ReportEvent pozwala testerowi zdecydować, co dokładnie zostanie zarejestrowane, kiedy i jak powinno zostać oznaczone.

Ten HP QTP Tutorial demonstruje zastosowanie funkcji Reporter.ReportEvent oraz Formatowanie wynikówW tym samouczku zostaniesz poproszony o utworzenie krótkiego skryptu. Ukończenie tego ćwiczenia skryptowego to najszybszy sposób, aby zobaczyć, jak niestandardowe raporty aktualizują drzewo wyników w czasie rzeczywistym.

Kliknij w tym miejscu jeśli film nie jest dostępny

Reporter.ReportEvent ma największe znaczenie w automatyzacji, ponieważ skrypt zazwyczaj działa bez nadzoru, zgodnie z harmonogramem lub w ramach procesu CI/CD. Plik z wynikami uruchomienia staje się jedynym zapisem tego, co się wydarzyło, więc krok, który kończy się niepowodzeniem lub przechodzi bez wyjaśnienia, znacznie utrudnia późniejsze debugowanie. Dodanie jawnego wywołania ReportEvent po wykonaniu krytycznej akcji przekształca drzewo wyników w czytelny, krok po kroku dziennik audytu, który tester, programista lub menedżer może przejrzeć bez otwierania skryptu.

Różni się to od punktu kontrolnego obiektu, który UFT generuje automatycznie i raportuje z użyciem własnej domyślnej nazwy kroku. Reporter.ReportEvent pozwala natomiast dołączyć sformułowanie o znaczeniu biznesowym, takie jak „Wyświetlono potwierdzenie zamówienia” zamiast ogólnego „Obiekt Check Point Pass on WebEdit”, który jest znacznie łatwiejszy do odczytania w raporcie końcowym dla osoby nietechnicznej. Metoda działa w ten sam sposób, niezależnie od tego, czy skrypt jest skierowany na stronę internetową, Windows aplikacji desktopowej lub terminalu komputera mainframe, ponieważ Reporter jest obiektem globalnym, a nie właściwością żadnego pojedynczego obiektu testowego.

Guru99 jest UFT/QTP seria obejmuje tę metodę zaraz po Instrukcje If, ​​Else i Exists, ponieważ większość wywołań Reporter.ReportEvent znajduje się w bloku warunkowym, który decyduje, czy wynik powinien zostać zgłoszony jako micPass czy micFail.

Składnia Reporter.ReportEvent i wartości EventStatus

Możesz użyć Reporter.ReportEvent aby raportować niestandardowe kroki testowe w Micro Focus UFTDrzewo wyników testów. Metoda akceptuje trzy wymagane argumenty i jeden argument opcjonalny, w ustalonej kolejności, jak pokazano poniżej.

Reporter.ReportEvent EventStatus, ReportStepName, Details [, ImageFilePath]

Status zdarzenia ustawia ikonę i kolor wyświetlany dla kroku i może zmienić ogólny stan przebiegu; NazwaKrokuRaportu jest krótką etykietą pojawiającą się w drzewie wyników testów, zazwyczaj zapisywaną jako oczekiwany wynik; Szczegóły zawiera dłuższy opis, zazwyczaj rzeczywisty zaobserwowany wynik; i opcjonalny Ścieżka pliku obrazu dołącza zrzut ekranu wykonany wcześniej w skrypcie do danego kroku.

WARTOŚĆ STAŁA WPŁYW NA WYNIKI WPŁYW NA STAN URUCHAMIANIA
0 micPass Krok jest oznaczony jako zaliczony w drzewie wyników Bez zmian; test nadal jest zaliczany
1 Błąd mikrofonu Krok jest oznaczony jako Niepowodzenie w drzewie wyników Całkowity status uruchomienia zmienia się na Niepowodzenie
2 micDone Krok jest wyświetlany jako komunikat informacyjny Brak zmian w statusie zaliczony/niezaliczony
3 Ostrzeżenie mikrofonu Krok jest wyświetlany jako ostrzeżenie Brak zmian w statusie zaliczony/niezaliczony

Każda stała może być również przekazana jako jej wartość liczbowa zamiast nazwy, więc Reporter.ReportEvent 1, „Krok”, „Szczegół” zachowuje się dokładnie tak samo Reporter.ReportEvent micFail, „Krok”, „Szczegóły”Użycie nazwanej stałej jest łatwiejsze do odczytania w skrypcie, który później będzie utrzymywany przez innego testera.

Skrypt zazwyczaj zagnieżdża kilka wywołań ReportEvent w ramach jednej akcji: wpis micDone przed rozpoczęciem akcji, jeden wpis micPass lub micFail dla sprawdzenia klucza i dodatkowe wpisy micWarning dla wszelkich zauważonych po drodze nieprawidłowości.

  • Gdy przypadki testowe są wykonywane za pomocą narzędzi automatyzacji, niektórym użytkownikom może być trudno zrozumieć surowe wyniki testów. Możesz użyć results.xml, aby utworzyć plik XSL prezentujący wyniki testów w preferowany przez Ciebie sposób.
  • Można również użyć VBScript funkcje biblioteki do zapisz wyniki w pliku xls lub tekstowym do raportowania na zewnątrz UFT.

Jak korzystać z Reporter.ReportEvent: Praktyczne przykłady

Znajomość składni to jedno; zobaczenie jej w prawdziwym skrypcie sprawia, że ​​cztery stałe statusu działają. Poniższy przykład umieszcza sprawdzenie w instrukcji If…Then…Else, a następnie raportuje wynik pozytywny lub negatywny za pomocą Reporter.ReportEvent, dzięki czemu wynik pojawia się w drzewie wyników dokładnie tam, gdzie oczekuje go recenzent.

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

Odzwierciedla to wzór pokazany na Guru99 jest Instrukcje warunkowe języka VBScript samouczek, w którym blok If…Then…Else wybiera pomiędzy dwoma wynikami; jedyną różnicą jest to, że każda gałąź wywołuje również Reporter.ReportEvent w celu zalogowania wyniku.

Zastosowanie micDone dla kroku, który ma charakter czysto informacyjny i Ostrzeżenie mikrofonu Gdy coś wygląda nietypowo, ale nie powinno od razu zakończyć się niepowodzeniem. Następny fragment kodu rejestruje krok wprowadzania danych jako „Ukończony”, a następnie oznacza wolną odpowiedź jako ostrzeżenie i dołącza zrzut ekranu za pomocą opcjonalnego argumentu ImageFilePath.

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

Trzymać NazwaKrokuRaportu krótki i zachowaj Szczegóły Konkretnie o rzeczywistym wyniku. Recenzent skanujący setki zarejestrowanych kroków po nieudanym nocnym uruchomieniu powinien być w stanie stwierdzić, co się stało, bez otwierania samego skryptu, a spójny wzorzec nazewnictwa dla każdej akcji znacznie przyspiesza skanowanie.

Zespoły wywołujące ReportEvent z wielu skryptów często przenoszą tę logikę do współdzielonej funkcji VBScript, takiej jak LogStep(status, nazwa, szczegóły), dzięki czemu każdy skrypt generuje spójne drzewo wyników bez powtarzania tego samego bloku If…Then.

Właściwości obiektu Reporter: Filtr, ReportPath i RunStatus

Reporter.ReportEvent to nie jedyny element obiektu Reporter. Trzy dodatkowe właściwości zapewniają dodatkową kontrolę nad zawartością wyników i miejscem ich umieszczenia. UFT przechowuje je i często pojawiają się w ramach automatyzacji produkcji.

NIERUCHOMOŚĆ CEL TYPOWE ZASTOSOWANIE
Filtruj Kontroluje, jakie typy zdarzeń są zapisywane w wynikach Reporter.Filter = rfEnableErrorsAndWarnings ukrywa pominięte kroki w dłuższej perspektywie
Ścieżka raportu Tylko do odczytu; zwraca folder, w którym przechowywane są wyniki bieżącego przebiegu resultsFolder = Reporter.ReportPath
Status uruchomienia Tylko do odczytu; zwraca aktualny status zaliczenia/niezaliczenia dotychczasowego przebiegu Jeśli Reporter.RunStatus = micFail, zakończ akcję

Reporter.Filter akceptuje cztery wartości: 0 lub rfEnableAll wyświetla każde zdarzenie i jest wartością domyślną; 1 lub rfEnableErrorsAndWarnings ukrywa pominięte kroki; 2 lub rfEnableErrorsOnly ukrywa zarówno pominięte kroki, jak i ostrzeżenia; a 3 lub rfDisableAll całkowicie wyłącza rejestrowanie wyników. Zaznaczenie Reporter.RunStatus w trakcie skryptu pozwala testowi na rozgałęzienie własnej logiki, na przykład pominięcieping pozostałe kroki w działaniu, gdy poprzedni krok zakończył się niepowodzeniem.

Ponieważ ReportPath i RunStatus są tylko do odczytu, nie można przypisać im wartości; można ich używać do odczytu informacji o bieżącym przebiegu, na przykład do zapisu ścieżki folderu wyników do pliku dziennika na początku skryptu lub do przerwania długiej akcji po krytycznym błędzie. Odczyt tych właściwości powoduje nieznaczne obciążenie, dlatego można bezpiecznie sprawdzać Reporter.RunStatus po każdym głównym kroku w długim zestawie regresji, nie spowalniając przebiegu w zauważalny sposób.

Najlepsze praktyki dla Reporter.ReportEvent w UFT

Kilka nawyków sprawia, że ​​raporty niestandardowe są przydatne, a nie tylko zakłócają pracę systemu.

  • Zarezerwuj micFail na prawdziwe awarie: Każde wywołanie micFail zmienia Reporter.RunStatus, więc używanie go do rozwiązywania problemów kosmetycznych ukrywa rzeczywiste defekty później w tym samym przebiegu.
  • Zapisz ReportStepName jako oczekiwany wynik: Recenzent powinien zrozumieć czek już na podstawie nazwy kroku, bez konieczności czytania kolumny Szczegóły.
  • Zrzuty ekranu wykonuj tylko w przypadku awarii: Przesyłanie ImageFilePath w każdym kroku szybko zapełnia folder z wynikami i spowalnia działanie, nie przynosząc większych korzyści.
  • Filtruj zaszumione przebiegi: Ustaw Reporter.Filter na rfEnableErrorsAndWarnings dla zaplanowanych przebiegów lub przebiegów ciągłej integracji, aby pominięte kroki nie przysłaniały istotnych błędów.
  • Scentralizuj logikę: Zawiń wywołania Reporter.ReportEvent w element wielokrotnego użytku akcja lub biblioteki funkcji, tak aby każdy skrypt w zestawie rejestrował wyniki w ten sam sposób.
  • Eksport dla czytelników nietechnicznych: Połącz plik results.xml z niestandardowym plikiem XSL, gdy interesariusze spoza zespołu ds. zapewnienia jakości muszą przejrzeć wyniki bez otwierania UFT.

FAQ

ReportEvent zapisuje zwykły tekst do drzewa wyników. ReportHTMLEvent, dostępny od UFT Wersja 12.52 akceptuje kod HTML w nazwie i szczegółach kroku, dzięki czemu w Przeglądarce wyników uruchomienia można pogrubiać, kolorować i formatować tekst.

Nie. Tylko micFail zmienia ogólny status przebiegu na Niepowodzenie. Zarówno micDone, jak i micWarning zapisują krok w drzewie wyników w celu uzyskania informacji, ale test nadal może zakończyć się jako Zaliczony, nawet jeśli zarejestrowano ostrzeżenia.

Tak. Przechwyć mapę bitową za pomocą metody CaptureBitmap obiektu, zapisz ją do pliku i przekaż ścieżkę do pliku jako opcjonalny czwarty argument ImageFilePath. UFT wyświetla obraz w panelu Przechwycone dane dla tego kroku.

Tak. Asystenci kodowania AI mogą generować szablony If…Then i ReportEvent na podstawie prostego opisu sprawdzenia, a także mogą oznaczać skrypty, które niewłaściwie używają micFail lub pomijają szczegóły. Tester powinien nadal potwierdzić, czy zalogowany status jest zgodny z rzeczywistym wynikiem.

Narzędzia do obserwacji oparte na sztucznej inteligencji mogą automatycznie podsumowywać przebieg i identyfikować anomalie, ale Reporter.ReportEvent nadal podaje precyzyjne, kontrolowane przez programistę nazwy kroków i statusy, które zasilają te narzędzia. Większość zespołów korzysta z obu tych funkcji jednocześnie, zamiast zastępować je jedną drugą.

Podsumuj ten post następująco: