Obsługa błędów eksportu

Obsługa błędów eksportu to mechanizm rejestrowania wierszy odrzuconych przy przenoszeniu danych na zewnątrz.

Rejestrowanie wierszy odrzuconych podczas eksportu

Obsługa błędów eksportu obejmuje wykrywanie rekordów, których nie można poprawnie zapisać w pliku albo przekazać do zewnętrznego systemu, oraz zapisanie informacji potrzebnych do ich późniejszej analizy. Odrzucenie wiersza może wynikać między innymi z braku wymaganej wartości, nieprawidłowego formatu daty, przekroczenia dozwolonej długości pola, niezgodnego typu danych albo naruszenia reguły unikalności. Sam komunikat „eksport zakończony błędem” nie wystarcza do ustalenia przyczyny, dlatego rejestr powinien wskazywać numer wiersza, nazwę pola, wartość powodującą problem i opis reguły, która nie została spełniona.

W praktyce warto rozróżnić błąd pojedynczego rekordu od błędu całego procesu. Jeżeli problem dotyczy tylko jednego wiersza, system może zapisać go na liście odrzuconych i kontynuować eksport pozostałych danych, o ile format docelowy i wymagania odbiorcy na to pozwalają. Błąd połączenia, brak dostępu do katalogu, uszkodzony plik wynikowy albo przerwanie zapisu może natomiast unieważnić całą operację. Raport powinien wtedy wyraźnie informować, czy powstał kompletny plik, częściowy plik, czy nie utworzono danych wynikowych.

Walidacja danych przed utworzeniem pliku wynikowego

Najmniej kosztownym sposobem ograniczenia błędów jest sprawdzenie danych przed właściwym eksportem. Walidacja może kontrolować obecność kolumn, kolejność pól, typy wartości, zakresy liczbowe, poprawność dat oraz zgodność znaków z kodowaniem używanym przez format docelowy. Przy eksporcie do CSV znaczenie mają także separator pól, znak cudzysłowu i sposób zapisu końca wiersza. Wartość zawierająca separator lub znak nowej linii musi zostać prawidłowo ujęta zgodnie z regułami obsługiwanymi przez program odbierający plik.

System powinien podawać wynik walidacji w sposób umożliwiający powtórzenie operacji. Przydatne są: identyfikator zadania, czas rozpoczęcia i zakończenia, liczba wierszy przeznaczonych do eksportu, liczba zapisanych rekordów oraz liczba odrzuconych pozycji. Jeżeli dane są dzielone na partie, raport powinien wskazywać także zakres lub identyfikatory rekordów należących do każdej partii. Taki zapis pozwala odróżnić błąd danych od problemu występującego dopiero przy określonym rozmiarze pliku albo przy konkretnej części zbioru.

Oddzielanie danych poprawnych od odrzuconych

Poprawnie zaprojektowany eksport nie powinien usuwać odrzuconych rekordów bez śladu ani zastępować ich pustymi wartościami. Dane odrzucone należy zachować w osobnym raporcie lub pliku błędów, najlepiej razem z identyfikatorem rekordu i informacją o etapie, na którym wystąpił problem. Jeśli błąd dotyczy przekształcenia, raport może wskazywać wartość źródłową oraz wynik transformacji. Jeżeli problem powstał podczas wysyłania do zewnętrznego odbiorcy, potrzebny jest również status odpowiedzi lub komunikat zwrócony przez ten system, o ile jest dostępny.

Istotna jest spójność między raportem a plikiem wynikowym. Liczba rekordów zapisanych, odrzuconych i pominiętych z innych powodów powinna odpowiadać liczbie rekordów wejściowych albo system powinien jasno opisać, dlaczego bilans się nie zgadza. Przy ponownym eksporcie mechanizm nie powinien bez kontroli dublować wcześniej przekazanych danych. Pomocne są identyfikatory operacji, znaczniki przetworzenia oraz możliwość uruchomienia eksportu wyłącznie dla rekordów oznaczonych jako błędne. Przed ponowieniem należy usunąć przyczynę odrzucenia, na przykład uzupełnić brakujące pole lub poprawić format wartości.

Diagnostyka eksportu na komputerze użytkownika

Na laptopie lub komputerze PC przyczyną błędów eksportu może być zarówno zawartość danych, jak i lokalne środowisko pracy. Należy sprawdzić, czy użytkownik ma uprawnienia do zapisu w wybranym katalogu, czy na dysku jest wystarczająca ilość wolnego miejsca oraz czy plik wynikowy nie jest otwarty przez inny program z blokadą zapisu. Przydatne jest wykonanie eksportu do nowego katalogu i pod inną nazwą, a następnie porównanie dziennika procesu z raportem odrzuconych wierszy. Jeżeli błąd występuje wyłącznie przy dużym zbiorze, trzeba sprawdzić pamięć operacyjną, limity aplikacji i sposób dzielenia danych na partie.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów i komputerów PC, a w ramach diagnostyki może sprawdzić działanie aplikacji eksportującej, dostęp do dysku, uprawnienia systemowe oraz poprawność zapisu plików. W przypadku powtarzających się błędów warto przekazać serwisowi dokładny komunikat, czas wystąpienia problemu, nazwę używanego programu i przykładowy raport odrzuconych rekordów bez modyfikowania jego treści. Takie informacje ułatwiają rozdzielenie awarii komputera od błędu konfiguracji lub nieprawidłowych danych wejściowych.