Ustawienia i mapowanie - konfiguracja parsera kodów GS1 i HIBC dla Smart Scan

Ekran Ustawienia i mapowanie ustala, jak transakcja Smart Scan czyta etykiety: które niezgodności kończą się błędem, a które ostrzeżeniem, jakiego separatora pól parser oczekuje od skanera i jak nazywa odczytane pola. Korzysta z niego administrator przy uruchamianiu stanowiska przyjęć oraz przy dostawcy, którego etykiety regularnie dostają werdykt bursztynowy. Profil parsera zapisuje się w pamięci przeglądarki, więc każde stanowisko konfiguruje się osobno.

Nagłówek ekranu przypomina, że zmiany działają w tym oknie od razu, a przycisk Zapisz konfigurację utrwala profil. Etykieta Profil: localStorage (DEMO) w prawym górnym rogu wskazuje miejsce zapisu. Karta Standard HIBC ma przełącznik Tryb rygorystyczny (strict), a karta Standard GS1 - weryfikację cyfr kontrolnych GTIN / SSCC / GLN i akceptację formatu czytelnego. Niżej leżą karta Separator pól (FNC1), normalizacja dat i tabela reguł mapowania.

Gdzie zapisuje się profil parsera

Profil obejmuje cztery przełączniki, znak separatora, tryb awaryjny przy braku separatora i listę reguł mapowania. Zapis trafia do pamięci przeglądarki (localStorage), a nie do bazy danych. Transakcja Smart Scan do weryfikacji etykiet wczytuje profil przy każdym odczycie, więc zapisana zmiana działa bez przeładowania strony.

Reguła stanowiska. Profil parsera dotyczy jednego komputera i jednej przeglądarki. Nie jest przypisany do magazynu, kontrahenta ani konta użytkownika - ten sam login na innym stanowisku pracuje z ustawieniami fabrycznymi, dopóki ktoś nie zapisze tam profilu. Wyczyszczenie danych przeglądarki również przywraca ustawienia fabryczne.

Tak samo zapisuje się układ kolumn w rejestrach, opisany na stronie personalizacja kolumn tabeli. Przy kilku stanowiskach przyjęć ustala się jeden profil, sprawdza go na przykładowych kodach i powtarza zapis na każdym komputerze. Zapisany profil widać w trybie tylko do odczytu w zakładce Wewnętrzne słowników standardów Auto ID.

Zmiany bez zapisu przepadają. Smart Scan czyta profil zapisany, więc do chwili kliknięcia Zapisz konfigurację weryfikuje etykiety według poprzednich ustawień. Zamknięcie ekranu bez zapisu kasuje zmiany.

Tryb rygorystyczny HIBC

Parser sumuje wartości wszystkich znaków kodu HIBC - łącznie z początkowym plusem - według 43-znakowego alfabetu i porównuje resztę z dzielenia przez 43 z ostatnim znakiem etykiety. Przełącznik decyduje tylko o tym, jak poważna jest niezgodność.

Tryb rygorystyczny jest włączony fabrycznie, a opis na ekranie zaleca go dla wyrobów medycznych i farmaceutyków. Wyłączenie ma sens na czas diagnozy etykiety, którą dostawca i tak musi poprawić. Zasady liczenia znaku kontrolnego opisują standardy etykietowania HIBCC.

Kontrola GS1 - cyfry kontrolne i format z nawiasami

Weryfikacja cyfr kontrolnych przelicza sumę mod 10 dla numerów GTIN, SSCC i GLN, czyli dla identyfikatorów 00, 01, 02 i 410. Po wyłączeniu parser nadal sprawdza, czy numer składa się z samych cyfr, ale sumy nie liczy, a protokół dostaje ostrzeżenie o wyłączonej weryfikacji. Etykieta GS1 nie może wtedy dostać werdyktu zielonego.

Drugi przełącznik dopuszcza zapis czytelny z identyfikatorami w nawiasach, np. (01)05909991234560(10)LOT1, przydatny przy przepisywaniu uszkodzonej etykiety; bez niego taki kod kończy się błędem struktury. Strumień ze skanera, bez nawiasów i z separatorem FNC1, jest przyjmowany zawsze, a adresy GS1 Digital Link parser rozkłada niezależnie od przełącznika.

Separator pól FNC1 i tryb awaryjny

Pola o stałej długości, np. GTIN pod identyfikatorem 01 (14 cyfr) albo termin ważności pod 17 (6 cyfr), nie potrzebują separatora - parser zna ich długość z wbudowanej tablicy zgodnej ze specyfikacją GS1. Pole zmiennej długości, np. partia 10 (do 20 znaków), musi kończyć się znakiem FNC1, chyba że stoi na końcu kodu.

Kolumna Długość słownika odróżnia pola stałe, np. stała 18 dla SSCC i stała 14 dla GTIN, od pól zmiennych wyróżnionych kolorem - jak partia pod identyfikatorem 10. Długości wszystkich identyfikatorów podaje lista identyfikatorów zastosowań GS1.

Pole Znak separatora przesyłany przez skaner ma dwie opcje: ASCII 29 - Group Separator (GS) albo Inny kod ASCII, po której wpisuje się kod od 1 do 255. Ekran podpowiada jednak przeprogramowanie czytnika kodem z jego instrukcji, opisanym zwykle jako Transmit Group Separator albo Map FNC1 to ASCII 29. W polu Smart Scan separator wstawia się też ręcznie skrótem Ctrl+].

Kiedy działa tryb awaryjny. Parser sięga po tryb awaryjny tylko wtedy, gdy po polu zmiennej długości nie ma separatora, a reszta kodu jest dłuższa niż maksymalna długość tego pola. Krótsza reszta to poprawne ostatnie pole - specyfikacja GS1 nie wymaga FNC1 na końcu kodu.

Normalizacja dat do ISO 8601

Daty w kodach GS1 mają zapis RRMMDD, a we flagach HIBC 14D i 16D - RRRRMMDD. Przełącznik normalizacji przelicza je na RRRR-MM-DD. Dwucyfrowy rok do 50 parser czyta jako 20RR, a od 51 do 99 jako 19RR. Dzień 00 oznacza według specyfikacji GS1 ostatni dzień miesiąca, więc (17)271100 parser odczyta jako 30 listopada 2027 r.

Wyłączona normalizacja wyłącza kontrolę terminu. Bez normalizacji Smart Scan pokazuje daty w zapisie z etykiety. Nadal odrzuca datę nieistniejącą, np. z miesiącem 13, ale nie ostrzega o terminie ważności, który już minął, a dziennik parsowania nie zapisuje dat odczytu. Na stanowisku przyjęć przełącznik powinien zostać włączony.

Reguły mapowania identyfikatorów na pola bazy

Reguła mapowania łączy identyfikator GS1 albo flagę HIBC z opisem i z polem bazy danych, zapisanym w konwencji tabela.kolumna. Zestaw fabryczny ma 23 reguły: 16 dla GS1 i 7 dla HIBC. Smart Scan bierze z reguły nazwę pola i pokazuje pole docelowe na kafelku dekompozytora.

Pole docelowe jest informacją. W wersji 2026.7 Smart Scan nie zapisuje odczytanych wartości do dokumentu magazynowego ani do kartoteki. Pole docelowe wskazuje, gdzie dana z etykiety ma swoje miejsce w systemie - partia przy pozycji dokumentu, GTIN w kartotece asortymentu. Towar przyjmuje się na stan dokumentem przyjęcia.

Skutek reguły w protokole Smart Scan zależy od jej stanu i od wbudowanej tablicy parsera.

• Reguła aktywna - kafelek dostaje opis i pole docelowe z reguły, a wartość przechodzi zwykłe kontrole daty albo cyfry kontrolnej.
• Reguła wyłączona - parser odczytuje wartość, ale kafelek identyfikatora GS1 dostaje ostrzeżenie, więc werdykt nie może być zielony.
• Identyfikator bez reguły - pole znane wbudowanej tablicy, np. wariant produktu 20, parser odczytuje jako spoza słownika mapowania i zgłasza ostrzeżenie.
• Identyfikator spoza tablicy - w zapisie z nawiasami odczyt kończy się ostrzeżeniem, a w strumieniu ze skanera błędem, bo parser nie zna długości pola. Reguła mapowania sprawia, że parser czyta go jak pole zmiennej długości, do separatora albo do 30 znaków.

Dodawanie i edycja reguły

Przycisk Dodaj regułę i ikona edycji otwierają okno reguły z tymi samymi polami.

Identyfikator musi być unikalny w obrębie standardu - druga reguła dla tego samego kodu kończy się komunikatem Duplikat reguły. Ten sam kod może natomiast wystąpić raz w GS1 i raz w HIBC. Nowa reguła trafi do Smart Scan dopiero po kliknięciu Zapisz konfigurację.

Typowe problemy z odczytem a ustawienia parsera

Zaskakujący werdykt często ma przyczynę w profilu stanowiska albo w skanerze, a nie w etykiecie.

Odczyty z problemami zbiera dziennik parsowania odczytów, opisany razem z innymi ekranami w przeglądzie modułu Auto ID.Dobór i programowanie czytnika omawia artykuł program magazynowy ze skanerem - dobór czytnika kodów.