Artykuły w kategorii

🧹 Wyniki walidacji, raporty i logi

Zaktualizowano miesiąc temu

W poprzednich artykułach pomyślnie wgraliśmy bazę danych, zmapowaliśmy kolumny i skonfigurowaliśmy reguły czyszczenia. Teraz przechodzimy do wielkiego finału. Pokażemy, jak bezpiecznie uruchomić proces, jak interpretować raporty wizualne, a przede wszystkim – jak czytać wynikowy, oczyszczony plik.

Podsumowanie, szacunkowa cena i uruchomienie

W ostatnim kroku (Zamówienie) zobaczysz przejrzyste podsumowanie tego, co ma się wydarzyć. Jeszcze przed wysłaniem pierwszego żądania aplikacja dokładnie obliczy szacunkową cenę w kredytach i pokaże przewidywany czas. Przy dokładnym oszacowaniu wyraźnie zobaczysz podział kosztów na poszczególne usługi (np. imiona, adresy, telefony).

Jeśli nie zrobiłeś tego jeszcze w zaawansowanych ustawieniach, wklej teraz swój klucz API z administracji Foxentry w pole Klucz API. Następnie wystarczy kliknąć przycisk, aby rozpocząć walidację.

Podsumowanie i zamówienie z szacunkową ceną oraz opcją wprowadzenia klucza API


💡 Bezpieczne przerywanie i wznawianie pracy

Przetwarzasz ogromny plik i musisz wyłączyć komputer? Żaden problem. Proces działa bezpiecznie i zapisuje dane sekwencyjnie. Jeśli w dowolnym momencie zamkniesz aplikację (lub okno przeglądarki), możesz uruchomić proces ponownie później. Aplikacja automatycznie wznowi pracę dokładnie w miejscu, w którym została przerwana, i nie pobierze ponownie kredytów za już przetworzone wiersze.

Przykład działającego procesu walidacji ze wskaźnikiem postępu


Wizualny raport z czyszczenia

Gdy proces dobiegnie końca, aplikacja natychmiast wygeneruje przejrzysty raport HTML i zapisze go w folderze z wynikami. Tutaj na pierwszy rzut oka zobaczysz ogólne podsumowanie i „wpływ Foxentry” – dowiesz się, o ile procent zmniejszył się wskaźnik błędów Twojej bazy danych i ile rekordów system uchronił przed odrzuceniem dzięki automatycznej korekcie. Znajdziesz tu również czytelne wykresy stanów końcowych dla poszczególnych usług.

Wynikowy raport HTML z wykresami i statystykami walidacji


Jak czytać plik wynikowy

Cleaner nigdy nie nadpisuje oryginalnego pliku wejściowego. Wynik zapisywany jest w podfolderze output/ dokładnie w tym samym formacie, co oryginał (oryginalny plik CSV pozostaje plikiem CSV, tabela Excela pozostaje tabelą Excela).

Wszystkie oryginalne kolumny pozostają całkowicie nienaruszone. Tuż obok nich aplikacja dodaje nowe kolumny z wynikami. Dla każdej zmapowanej grupy zobaczysz te nowe kolumny:

  • _result: zrozumiały tekstowy status rekordu (np. ważny, poprawiony, nieważny),
  • _updated: wartość po ewentualnej korekcie. Jeśli Foxentry naprawił wartość (np. literówkę w adresie e-mail), czystą wersję znajdziesz właśnie tutaj. Jeśli wartość była poprawna, jest równa oryginałowi,
  • _suggestion: alternatywna propozycja. Jeśli wartość jest nieważna, ale API znalazło prawdopodobnego kandydata, zostanie on tutaj wypisany,
  • _note: szczegółowy komunikat o błędzie (np. wyjaśnienie, dlaczego adres lub telefon jest nieważny).
Przykład pliku wynikowego z oczyszczonymi danymi i notatkami o stanie


💡 Wskazówka dotycząca przetwarzania danych

Zalecamy sortowanie oryginalnej kolumny i nowej kolumny kończącej się na _updated obok siebie. W ten sposób od razu zobaczysz, jakie konkretnie litery lub szczegóły poprawiło Foxentry. W przypadku rekordów oznaczonych statusem nieważny (istnieje propozycja), sprawdź wartość w kolumnie _suggestion i sam zdecyduj, czy chcesz ręcznie zaakceptować poprawkę.

Wzbogacone dane (full datascope)

Jeśli w kroku trzecim włączyłeś rozszerzone wzbogacanie danych dla wybranych usług, Foxentry doda dodatkowe oddzielne kolumny na samym końcu tabeli. W zależności od walidowanej usługi, znajdziesz tutaj bogate informacje dodatkowe – w przypadku imion może to być rozdzielone imię i nazwisko, prawidłowy wołacz lub określenie płci. W przypadku firm dowiesz się na przykład o pełnym kodzie działalności (NACE) i statusie płatnika VAT, podczas gdy adresy zostaną uzupełnione o współrzędne GPS, województwo, powiat i inne szczegóły administracyjne.

Przykład pliku wynikowego wzbogaconego o dodatkowe kolumny danych (full datascope)


Logi techniczne ułatwiające audyt

Foxentry Data Cleaner oferuje również szczegółową przeglądarkę logów żądań (request logs). Domyślnie zapisywanie logów jest wyłączone w celu ochrony danych i oszczędności miejsca na dysku. Można je łatwo włączyć za pomocą pola wyboru na samym dole strony Zamówienie (krok 4).

Jeśli włączysz logowanie dla danego przebiegu, zapisane zostanie kompletne żądanie wysłane do API oraz pełna odpowiedź z serwera (Twój klucz API w nagłówku pozostaje zamaskowany ze względów bezpieczeństwa). Zapisy te można następnie przeglądać w przejrzystej interaktywnej przeglądarce (kliknij przycisk Logi na górnym pasku). Można je filtrować według kodów statusu (np. 2xx, 4xx, 5xx), wyszukiwać błędne rekordy i szczegółowo analizować odebrane dane JSON.

Przeglądarka technicznych logów żądań z opcjami filtrowania


Mamy nadzieję, że ta trzyczęściowa seria pomogła Ci w szybkim starcie. Dzięki Foxentry Data Cleaner masz teraz do dyspozycji potężne i w pełni bezpieczne narzędzie, dzięki któremu Twoja baza klientów będzie zawsze aktualna, wolna od błędów i w pełni gotowa do dalszych działań marketingowych.

Nadal nie wiesz? Napisz do nas.