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.

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.
