Plik został wczytany, aplikacja nie zgłosiła błędu, a ceny części produktów są nieprawidłowe. To jeden z najbardziej kłopotliwych scenariuszy importu: proces technicznie się udał, lecz firma pracuje na błędnych danych. Dobry importer powinien sprawdzać nie tylko, czy da się odczytać komórki, ale też co ich zawartość oznacza i jakie zmiany wywoła.
Poniżej opisuję sposób projektowania importu z Excela lub CSV do firmowej aplikacji: od uzgodnienia formatu, przez podgląd zmian, po zapis i raport. Wszystkie przykłady biznesowe są hipotetyczne — nie opisują realizacji ani wyników klientów Inkluzji.
Problem zaczyna się przed zapisem do bazy
Wyobraźmy sobie hurtownię aktualizującą kartotekę produktów z pliku dostawcy. Kod 00127 zostaje odczytany jako liczba 127. Puste pole ceny jest interpretowane jako zero. Liczba 1,250 może oznaczać wartość z trzema miejscami po przecinku albo liczbę z separatorem tysięcy. Żaden z tych przypadków nie musi spowodować awarii programu.
Najpierw trzeba ustalić kontrakt danych, czyli jednoznaczne zasady wymiany. Powinien określać wymagane kolumny, typy wartości, format dat i liczb, jednostki, dopuszczalne puste pola oraz sposób identyfikacji rekordu. Dla CSV dochodzą kodowanie, separator pól i zasady cytowania. Plik CSV i skoroszyt XLSX wymagają różnych mechanizmów odczytu; zmiana rozszerzenia niczego nie konwertuje.
- Identyfikator produktu jest tekstem. Zera na początku mogą być częścią kodu. Jeśli zostały utracone jeszcze w pliku źródłowym, importer nie powinien ich zgadywać.
- Pusta cena wymaga ustalonej interpretacji. Może oznaczać „nie zmieniaj”, „brak danych” albo błąd. Zero jest osobną wartością.
- Format liczby jest częścią umowy. Automatyczna zamiana wszystkich przecinków na kropki nie rozwiązuje problemu separatorów tysięcy.
- Brak produktu w pliku nie oznacza usunięcia. Taka operacja wymaga osobno uzgodnionej reguły, zwłaszcza gdy dostawca przesyła tylko zmiany.

Bezpieczny import ma etap próbny
Plik nie powinien od razu nadpisywać danych używanych przez pracowników. Przydatna jest strefa pośrednia, nazywana stagingiem: oddzielne miejsce, do którego trafiają odczytane wiersze wraz z numerem partii i numerem wiersza źródłowego. Pozwala to sprawdzić zawartość i przygotować raport przed zmianą kartoteki.
- Odbiór: sprawdzenie uprawnień, rodzaju i rozmiaru pliku oraz nadanie identyfikatora importu.
- Odczyt: zachowanie wartości źródłowych i jawne przekształcenie ich do uzgodnionego formatu.
- Walidacja: sprawdzenie kolumn, wartości, powiązań i reguł biznesowych.
- Podgląd: zestawienie nowych rekordów, zmian, pozycji bez zmian i błędów.
- Zatwierdzenie: zapis według wybranej strategii oraz trwałe podsumowanie wyniku.
Raport „wiersz 84 jest niepoprawny” niewiele pomaga. Lepszy komunikat brzmi: „Wiersz 84, kolumna Cena: wpisano «brak», a wymagane jest nieujemne pole liczbowe. Popraw wartość lub zastosuj uzgodnione oznaczenie pominięcia”. Raport powinien pozwalać poprawić źródło bez konsultacji z programistą przy każdym błędzie.
W procesie automatycznym zatwierdzenie może odbywać się bez człowieka, lecz według jawnych warunków. Przykładowa reguła projektowa to zatrzymanie partii, gdy zmiana ceny przekracza ustalony z właścicielem procesu próg. To nie jest uniwersalna norma: inne ograniczenia pasują do katalogu produktów, inne do kursów walut.
Poprawny format to dopiero pierwsza warstwa kontroli
Liczba może być poprawna technicznie i błędna biznesowo. Cena 12.50 da się zapisać w bazie, ale nadal trzeba wiedzieć, czy jest netto czy brutto, w jakiej walucie oraz za sztukę czy opakowanie. Importer nie może samodzielnie dopowiadać tych znaczeń.
W praktyce warto sprawdzać cztery warstwy: strukturę pliku, typ i zakres wartości, zgodność z kartotekami oraz sens całej partii. Ostatnia warstwa obejmuje na przykład nieoczekiwany spadek liczby pozycji lub aktualizację niemal całej kartoteki, gdy zwykle zmienia się niewielki fragment. Takie sygnały powinny wywoływać ostrzeżenie lub zatrzymanie zgodnie z uzgodnioną polityką.
Powtarzające się kody w jednym pliku wymagają rozstrzygnięcia. „Ostatni wiersz wygrywa” jest regułą biznesową, a nie neutralnym szczegółem technicznym. Najbezpieczniej odrzucić niejednoznaczność, chyba że źródło ma udokumentowaną kolejność i znaczenie kolejnych rekordów. Problem ponownego uruchomienia tego samego importu opisuje również artykuł o idempotencji i duplikatach w integracjach.
Zapisać wszystko czy tylko poprawne wiersze?
Import atomowy oznacza, że cała wybrana jednostka pracy zostaje zapisana albo żaden jej element. Jest dobrym punktem wyjścia dla niewielkiej, powiązanej partii, np. dokumentu z pozycjami. Firma nie dostaje połowy dokumentu bez jasnej informacji, co się wydarzyło.
Import częściowy zapisuje poprawne, niezależne jednostki, a resztę kieruje do poprawy. Może pasować do dużego katalogu, ale wymaga raportu pokazującego dokładnie, co już zatwierdzono. Ponowienie nie może ponownie wykonać skutków zakończonych operacji. Gdy rekordy tworzą komplet, granicą partii powinien być cały komplet, a nie przypadkowe tysiąc wierszy.
Jedna długa transakcja, czyli operacja grupująca zmiany w bazie, upraszcza zasadę „wszystko albo nic”, lecz może długo utrzymywać blokady i zwiększać obciążenie dziennika transakcyjnego. Dzielenie zapisu na krótsze partie ogranicza ten koszt, ale komplikuje wznowienie. Wielkość partii dobiera się na podstawie pomiarów na reprezentatywnych danych, nie uniwersalnej magicznej liczby. Zobacz również jak diagnozować wydajność aplikacji i bazy danych.
Podgląd zmian może się zdezaktualizować
Między sprawdzeniem pliku a zatwierdzeniem ktoś może ręcznie zmienić cenę w aplikacji. Sam staging nie zabezpiecza przed jej nadpisaniem. Etap zapisu powinien ponownie sprawdzić istotne warunki, np. wersję rekordu, a konflikt pokazać użytkownikowi. Mechanizm ten wyjaśniam szerzej we wpisie o jednoczesnej edycji i utraconych zmianach.
Zatwierdzana partia musi też odpowiadać tej, którą sprawdzono. Po walidacji należy zablokować jej edycję albo wymusić ponowne sprawdzenie po zmianie danych lub reguł. Raport powinien zapisywać wersję użytego szablonu i reguł walidacji. Inaczej dwie osoby mogą uzyskać różne wyniki dla pozornie tego samego importu.
Dla dociekliwych: kontrola konwersji w SQL Server
Poniższy samodzielny przykład sprawdza wyłącznie, czy tekst ceny da się przekształcić do wskazanego typu i czy wynik nie jest ujemny. Zakłada wcześniejsze ustalenie formatu z kropką dziesiętną i bez separatorów tysięcy. Nie jest kompletnym importerem ani ścisłym walidatorem zapisu liczby.
DECLARE @Dane TABLE (
Wiersz int,
CenaTekst nvarchar(50)
);
INSERT INTO @Dane VALUES
(2, N'12.50'), (3, N'brak'), (4, N''), (5, N'-3.00');
SELECT d.Wiersz, d.CenaTekst, p.Cena,
CASE
WHEN n.Tekst IS NULL THEN N'Brak ceny'
WHEN p.Cena IS NULL THEN N'Niepoprawna liczba lub zakres'
WHEN p.Cena < 0 THEN N'Cena nie może być ujemna'
ELSE N'Konwersja poprawna'
END AS Wynik
FROM @Dane AS d
CROSS APPLY (
VALUES (NULLIF(LTRIM(RTRIM(d.CenaTekst)), N''))
) AS n(Tekst)
CROSS APPLY (
VALUES (TRY_CONVERT(decimal(12,2), n.Tekst))
) AS p(Cena);
TRY_CONVERT zwraca NULL, gdy taka konwersja tekstu na liczbę się nie powiedzie. Dla konwersji jawnie niedozwolonych nadal może zgłosić błąd. Osobne rozpoznanie pustego tekstu pozwala odróżnić brak wartości od błędnego formatu. Ważne ograniczenie: konwersja do dwóch miejsc po przecinku może zaokrąglić wynik. Jeśli biznes zabrania dodatkowych miejsc, trzeba sprawdzić precyzję przed konwersją, zamiast uznać sam jej sukces za akceptację. Szczegóły opisuje dokumentacja Microsoft.
Właściwy zapis wymaga osobnej transakcji i obsługi błędów. W SQL Server SET XACT_ABORT ON powoduje wycofanie transakcji przy błędach wykonania objętych tym mechanizmem; nie obejmuje błędów kompilacji. Nie zastępuje to walidacji ani obsługi wyjątków. Patrz dokumentacja SET XACT_ABORT.
Plik wejściowy też wymaga zabezpieczeń
Importer powinien przyjmować tylko potrzebne formaty, ograniczać rozmiar oraz koszt przetwarzania i sprawdzać uprawnienia użytkownika. Rozszerzenie i deklarowany typ MIME nie wystarczają do uznania pliku za bezpieczny. Plików źródłowych nie należy udostępniać publicznie; trzeba ustalić czas ich przechowywania i chronić je tak jak zawarte w nich dane. To podejście jest zgodne z zaleceniami OWASP dotyczącymi przesyłania plików.
Nie ma powodu, by importer cennika wykonywał makra lub pobierał zewnętrzne odwołania ze skoroszytu. Obsługa formuł wymaga jawnej decyzji: odrzucenie, odczyt zapisanych wyników albo kontrolowane przeliczenie. Zapisany wynik może być nieaktualny, więc sam odczyt wartości komórki nie rozstrzyga jej poprawności. W raporcie błędów udostępniaj tylko dane potrzebne do korekty, a nie pełną zawartość wrażliwych rekordów.
Jak odebrać gotowy importer: sześć prób
- Kod z zerem na początku: po imporcie ma pozostać dokładnie tym samym identyfikatorem.
- Pusta cena i cena zero: system powinien odróżnić oba przypadki według ustalonych reguł.
- Błędny wiersz w środku pliku: raport ma wskazać przyczynę i stan pozostałych danych zgodnie z wybraną polityką zapisu.
- Powtórzenie zakończonej operacji: nie może utworzyć dodatkowych rekordów ani powtórzyć jej skutków.
- Awaria w czasie zapisu: po wznowieniu wynik musi być jednoznaczny; nie wystarczy zniknięcie komunikatu o błędzie.
- Ręczna zmiana po podglądzie: import ma wykryć konflikt lub zastosować wcześniej zaakceptowaną regułę jego rozstrzygnięcia.
Do odbioru potrzebny jest zestaw plików z oczekiwanymi wynikami, a nie tylko demonstracja jednego idealnego arkusza. Dodatkowo należy zmierzyć czas przetwarzania i wpływ na pracę innych użytkowników przy realistycznej wielkości danych.
Dobry importer daje firmie kontrolę nad zmianą. Pokazuje, co zamierza zrobić, dlaczego odrzuca dane i co rzeczywiście zapisał. Warto zamówić go razem z regułami walidacji, raportem i testami awarii — samo dodanie przycisku „Wczytaj Excel” rozwiązuje tylko początek problemu.
Jeśli planujesz przenoszenie danych między arkuszami a firmową aplikacją, opisz źródło danych i oczekiwane zmiany. Do wstępnej rozmowy wystarczy struktura kolumn i przykłady bez danych osobowych oraz tajemnic firmy.
Źródła techniczne zweryfikowano 17 listopada 2026 r. Zdjęcie główne: Carlos Muza, Unsplash License. Obie fotografie są ilustracyjne i nie przedstawiają realizacji Inkluzji.
