Studio WMS.net - instrukcja obsługi

Dziennik parsowania - rejestr odczytów kodów i analiza błędów etykiet

Dziennik parsowania zapisuje każdy odczyt wykonany w transakcji Smart Scan, niezależnie od werdyktu parsera. Jeden wiersz odpowiada jednemu skanowi i przechowuje surowy ciąg znaków, rozpoznany standard i werdykt wraz z pierwszym komunikatem błędu. Kierownik magazynu ustala tu, czy problem leży w etykiecie dostawcy, czy w ustawieniach skanera.

Studio WMS.net - dziennik parsowania z filtrami okresu i werdyktu, wyborem standardu, wyszukiwarką oraz czterema wskaźnikami odczytów
Dziennik parsowania w bazie demonstracyjnej - pusty rejestr z ostatnich 7 dni i wskaźniki liczone z bieżącego filtra.

Pasek filtrów zawiera przełącznik okresu (Dziś, 7 dni, 30 dni), przyciski werdyktu, listę standardów i wyszukiwarkę z przyciskami Szukaj oraz Odśwież. Pod nim leżą cztery kafelki: Odczyty (filtr), Poprawne etykiety, Błędy, Ostrzeżenia. Niżej zaczyna się Rejestr odczytów (TOP 500) z przyciskiem Eksport XLS. W bazie demonstracyjnej w chwili zrzutu dziennik z ostatnich siedmiu dni był pusty, a komunikat podpowiadał, że wpisy pojawiają się po odczycie w Smart Scan.

Na tej stronie

  1. Skąd biorą się wpisy w dzienniku
  2. Cztery werdykty parsera
  3. Filtry i wskaźniki nad rejestrem
  4. Kolumny rejestru odczytów
  5. Analiza błędów według komunikatu i prefiksu dostawcy
  6. Separator FNC1 i znacznik GS w surowym ciągu
  7. Jak przygotować zestawienie wadliwych etykiet dla dostawcy
  8. Ćwiczenie: wykonaj błędny odczyt w Smart Scan i znajdź go w dzienniku
  9. Najczęstsze pytania
  10. Słownik pojęć

Skąd biorą się wpisy w dzienniku

Jedynym źródłem wpisów jest transakcja Smart Scan: po każdym odczycie zapisuje wynik parsera w dzienniku, także wtedy, gdy kodu nie rozpoznała. Zapis jest dodatkiem do odczytu - jeśli się nie powiedzie, weryfikacja etykiety na ekranie działa dalej. Smart Scan nie tworzy przy tym pozycji dokumentu magazynowego, więc dziennik rejestruje odczyty, a nie ruch towaru.

Studio WMS.net - transakcja Smart Scan z polem skanowania i przykładowymi kodami GS1 oraz HIBC, w tym celowo błędnymi etykietami
Smart Scan zasila dziennik parsowania - wpis powstaje także po kliknięciu przykładowego kodu z celowym błędem.

Pod polem skanowania leżą przykładowe kody: poprawne etykiety GS1 i HIBC, adres GS1 Digital Link oraz przykłady oznaczone czerwonym krzyżykiem - GTIN z błędną sumą kontrolną, HIBC ze złym znakiem kontrolnym i etykieta w obcym formacie. Komunikat formularza o braku zapisu w wersji demonstracyjnej dotyczy pozycji przyjęcia; sam odczyt trafia do dziennika. Działanie transakcji opisuje strona Smart Scan - weryfikacja i dekompozycja etykiet, a pozostałe ekrany modułu - przegląd modułu Auto ID do automatycznej identyfikacji towarów.

Cztery werdykty parsera

Werdykt podsumowuje protokół kontroli, który Smart Scan wykonuje przy każdym odczycie: rozpoznanie standardu, strukturę pól, cyfry kontrolne oraz daty. W dzienniku zapisuje się werdykt i pierwszy komunikat, który zgłosił ostrzeżenie albo błąd. Typowe przyczyny błędów po stronie etykiet i czytników omawia artykuł błędy parsowania kodów kreskowych.

WerdyktZnaczenieTypowa przyczynaCo zrobić
PoprawnyStruktura, sumy kontrolne i daty zgodne ze standardem.-Etykieta nadaje się do automatycznej obsługi.
OstrzeżenieKod odczytany, ale część kontroli zgłasza zastrzeżenia - etykieta warunkowo zgodna.Brak separatora FNC1 i odczyt w trybie awaryjnym, termin ważności w przeszłości, znak kontrolny HIBC w trybie łagodnym.Sprawdzić ustawienia skanera albo datę na etykiecie.
BłądKod wygląda na GS1 albo HIBC, ale nie przechodzi weryfikacji.Błędna cyfra kontrolna GTIN albo SSCC (modulo 10), zły znak kontrolny HIBC (modulo 43) w trybie rygorystycznym.Zgłosić dostawcy etykiet; numeru z takiej etykiety nie przepisywać ręcznie do dokumentów.
NierozpoznanyTreść spoza obsługiwanych standardów.Etykieta wewnętrzna albo kod w obcym formacie.Ustalić, czy etykietę trzeba obsłużyć własną regułą mapowania.

Tryb rygorystyczny HIBC i weryfikację sum kontrolnych ustawia profil parsera. Profil zapisuje się w pamięci przeglądarki, dlatego werdykt w dzienniku zależy od ustawień stanowiska, z którego wykonano skan - tę samą etykietę dwa komputery mogą ocenić różnie. Ustawienia profilu opisuje strona ustawienia i mapowanie parsera kodów.

Filtry i wskaźniki nad rejestrem

Okres domyślnie obejmuje 7 dni i liczy się od północy: 7 dni oznacza odczyty od północy siedem dni temu do teraz. Zmiana werdyktu albo standardu (GS1, HIBC, GS1-DL, NIEZNANY) od razu odpytuje bazę; frazę zatwierdza przycisk Szukaj albo klawisz Enter. Zmiana okresu i przycisk Odśwież przeładowują dodatkowo panele analizy błędów.

Wyszukiwarka porównuje frazę z surowym ciągiem odczytu, komunikatem błędu, loginem operatora, numerem GTIN i partią. Nazwy towaru nie przeszukuje, choć podpowiedź w polu ją wymienia - towar znajdziesz po fragmencie numeru GTIN.

Wskaźniki nad rejestrem liczą się z tych samych wierszy, które pokazuje tabela. Odczyty (filtr) podaje ich liczbę, Poprawne etykiety - udział odczytów z werdyktem Poprawny, a Błędy i Ostrzeżenia - liczby odczytów z tymi werdyktami. Odczyty nierozpoznane nie mają osobnego kafelka, ale obniżają udział poprawnych. Rejestr obejmuje najwyżej 500 najnowszych odczytów, więc przy dużym ruchu wskaźniki opisują 500 ostatnich skanów z okresu.

Kolumny rejestru odczytów

Wiersze stoją od najnowszego. Odczyty z werdyktem Błąd mają jasnoczerwone tło, a stopka podaje liczbę wierszy po filtrowaniu.

KolumnaZawartośćJak wykorzystać
CzasGodzina i data odczytu.Kolejność zdarzeń przy jednej dostawie.
OperatorLogin; po najechaniu myszą - stanowisko, jeśli jest znane.Kto skanował i na którym stanowisku.
ŹródłoTransakcja, z której pochodzi odczyt.W obecnej wersji zawsze SMARTSCAN.
StandardGS1, HIBC albo NIEZNANY. Smart Scan zapisuje adresy GS1 Digital Link ze standardem GS1, dlatego filtr GS1-DL ich nie pokazuje. Po najechaniu - symbolika, np. GS1-128 albo GS1 DataMatrix.Rodzaj kodu, który przeczytał skaner.
WerdyktPoprawny, Ostrzeżenie, Błąd, Nierozpoznany.Filtrowanie problemów.
IdentyfikatorGTIN, SSCC albo LIC z kodu HIBC, z podpisem rodzaju.Zebranie odczytów jednego towaru albo palety.
PartiaNumer partii z kodu.Kontrola partii przyjmowanej dostawy.
TowarIndeks i nazwa z kartoteki dopasowanej po GTIN.Puste pole oznacza GTIN spoza kartoteki.
BłądPierwszy komunikat protokołu, skrócony; pełna treść w podpowiedzi.Przyczyna werdyktu.
RAWPoczątek surowego ciągu ze znacznikiem separatora.Analiza struktury kodu.

Kolumna Towar wypełnia się, gdy numer GTIN z kodu pasuje do kodu EAN w kartotece; GTIN-14 z zerem na początku pasuje także do EAN-13. Kody EAN w kartotece opisuje strona kartoteka asortymentu.

Analiza błędów według komunikatu i prefiksu dostawcy

Studio WMS.net - dziennik parsowania z paskiem filtrów, wskaźnikami, pustym rejestrem odczytów i nagłówkami paneli analizy błędów
Pod rejestrem odczytów leżą dwa panele analizy: najczęstsze komunikaty parsera i jakość etykiet według prefiksu dostawcy.

Ten zrzut z bazy demonstracyjnej pokazuje całą szerokość ekranu: filtry i cztery kafelki w jednym rzędzie, pusty rejestr ze stopką Razem (filtr): 0 oraz nagłówki sekcji Analiza błędów parsowania. Panele analizy są puste, bo w okresie 7 dni nie było odczytów.

Panel Najczęstsze błędy parsera grupuje ostrzeżenia i błędy z wybranego okresu według treści komunikatu - do 20 najczęstszych. Wiersz podaje liczbę wystąpień, rozbicie na błędy i ostrzeżenia oraz datę ostatniego wystąpienia, a pasek pokazuje częstość względem najczęstszego komunikatu. Jeden komunikat w wielu wierszach zwykle oznacza jedną przyczynę: źle ustawiony skaner albo serię etykiet z tej samej drukarki.

Wykres Jakość etykiet wg dostawcy / prefiksu pokazuje do 15 grup w poziomych słupkach, od grupy z największą liczbą błędów. Słupek grupy ma odcinki werdyktów (Poprawny, Ostrzeżenie, Błąd); odczyty nierozpoznane nie mają własnego odcinka. Grupą jest siedem pierwszych cyfr numeru GTIN (dla SSCC - siedem cyfr po cyfrze rozszerzenia), identyfikator etykietującego LIC dla kodów HIBC albo pozycja "poza standardem". Prefiks firmy GS1 ma zmienną długość, więc grupa wskazuje dostawcę w przybliżeniu - dwie firmy o wspólnym początku numeru trafią do jednego słupka. Oba panele uwzględniają tylko okres; pozostałe filtry ich nie zmieniają.

Separator FNC1 i znacznik GS w surowym ciągu

Znak ASCII 29 w dzienniku. W kodach GS1-128 i GS1 DataMatrix pole o zmiennej długości, na przykład partia, kończy się znakiem FNC1, jeśli po nim następuje kolejne pole. Skaner przekazuje go do programu jako niewidoczny znak sterujący GS (ASCII 29). Dziennik zapisuje ten znak w surowym ciągu jako tekst <GS>, a ekran pokazuje go jako znacznik ⟨GS⟩, dzięki czemu granice pól widać w tabeli i w eksporcie.

Brak znacznika tam, gdzie powinien stać separator, zwykle oznacza skaner ustawiony tak, że pomija FNC1. Parser próbuje wtedy odczytać pola w trybie awaryjnym, według maksymalnych długości, i zgłasza ostrzeżenie.Rozwiązaniem jest włączenie w skanerze przesyłania separatora grupy (GS). Które identyfikatory mają zmienną długość i wymagają separatora, podaje rejestr identyfikatorów zastosowań GS1.

Jak przygotować zestawienie wadliwych etykiet dla dostawcy

Procedura prowadzi od wykresu jakości etykiet do pliku, który można dołączyć do reklamacji.

  1. Ustaw okres

    Wybierz 30 dni. Zmiana okresu przeładuje także panele analizy.

  2. Znajdź grupę z błędami

    Na wykresie Jakość etykiet wg dostawcy / prefiksu odczytaj grupę z najdłuższym odcinkiem błędów i zanotuj cyfry jej prefiksu.

  3. Zawęź rejestr

    Wybierz werdykt Błędy, wpisz cyfry prefiksu w wyszukiwarkę i kliknij Szukaj. Fraza dopasuje się do numerów GTIN i surowych ciągów.

  4. Sprawdź przyczynę

    Porównaj kolumnę Błąd z panelem Najczęstsze błędy parsera. Jeden powtarzający się komunikat wskazuje na wspólną przyczynę po stronie drukarki etykiet.

  5. Wyeksportuj wynik

    Kliknij Eksport XLS. Plik ma 17 kolumn, w tym stanowisko i symbolikę oraz pełny surowy ciąg ze znacznikiem separatora.

Eksport obejmuje te same wiersze co rejestr, czyli najwyżej 500 - przy większej liczbie odczytów najpierw zawęź okres albo frazę. Plik powstaje w przeglądarce jako tabela w formacie zgodnym z Excelem, dlatego Excel może przy otwarciu zapytać o zgodność formatu z rozszerzeniem .xls. Ten sam zestaw danych w skrócie, z wykresem godzinowym, pokazuje Dashboard Auto ID ze statystykami odczytów.

Ćwiczenie w demo - lekcja lub zajęcia

Ćwiczenie: wykonaj błędny odczyt w Smart Scan i znajdź go w dzienniku

Uczeń porównuje, jak parser ocenia etykiety z różnymi wadami. Rola w demo: kierownik magazynu. Czas: około 15 minut.

  1. Otwórz demo Studio WMS.net w roli kierownika magazynu i przejdź do AUTO ID, Smart Scan.
  2. Kliknij kolejno przykładowe kody Paleta SSCC, GTIN - błędna suma kontrolna oraz Etykieta własna (obcy format) i zanotuj werdykty.
  3. Przejdź do AUTO ID, Dziennik parsowania, ustaw okres Dziś i odszukaj swoje odczyty po godzinie - konto demo jest wspólne, więc w rejestrze mogą być też odczyty innych osób.
  4. Dla odczytu z błędem przeczytaj pełną treść kolumny Błąd i kolumnę RAW. Policz cyfrę kontrolną numeru GTIN i porównaj wynik z kalkulatorem cyfry kontrolnej GS1.
  5. Wybierz werdykt Błędy i sprawdź, jak zmieniły się wskaźniki oraz panel Najczęstsze błędy parsera.

Pytanie kontrolne. Dlaczego etykieta z błędną cyfrą kontrolną dostaje werdykt Błąd, a etykieta w obcym formacie - Nierozpoznany, i która z tych sytuacji jest groźniejsza dla poprawności danych w magazynie?

Podstawa programowa. Ćwiczenie realizuje efekt "stosuje systemy informatyczne w procesie magazynowania" z kwalifikacji SPL.01 Obsługa magazynów (jednostka SPL.01.5), w powiązaniu ze znakowaniem zapasów według standardów GS1. Pozostałe ćwiczenia zebraliśmy na stronie demo WMS na zajęciach z gospodarki magazynowej.

Najczęstsze pytania

Czy dziennik rejestruje odczyty z kolektora i z ekranu jednostek SSCC?

Nie. W obecnej wersji wpisy tworzy wyłącznie transakcja Smart Scan. Skan opakowania na ekranie jednostek logistycznych ani operacje na kolektorze nie trafiają do dziennika.

Dlaczego filtr Dziś pokazuje więcej odczytów niż kafelek Skany dziś na dashboardzie?

Okres w dzienniku liczy się od północy odpowiedniej liczby dni wstecz, więc filtr Dziś obejmuje odczyty od północy dnia poprzedniego. Kafelek na dashboardzie liczy od północy dnia bieżącego.

Czy eksport XLS obejmuje wszystkie odczyty z okresu?

Nie. Eksport zapisuje wiersze rejestru, a rejestr pokazuje najwyżej 500 najnowszych odczytów. Przy większym ruchu zawęź okres albo werdykt przed eksportem.

Czy wpis w dzienniku oznacza, że towar został przyjęty?

Nie. Dziennik rejestruje odczyt etykiety, a nie ruch magazynowy. Towar przyjmuje się dokumentem przyjęcia, który zmienia stan dopiero po zatwierdzeniu.

Dlaczego ta sama etykieta ma różne werdykty na dwóch stanowiskach?

Profil parsera, w tym tryb rygorystyczny HIBC i weryfikacja sum kontrolnych, zapisuje się w pamięci przeglądarki każdego stanowiska osobno. Różne ustawienia dają różne werdykty dla tego samego kodu.

Słownik pojęć

Parsowanie
Rozkład odczytanego ciągu znaków na pola danych według reguł standardu, np. identyfikatorów zastosowań GS1.
Werdykt parsera
Wynik protokołu kontroli etykiety: Poprawny, Ostrzeżenie, Błąd albo Nierozpoznany.
Surowy ciąg (RAW)
Treść przekazana przez skaner przed interpretacją; w dzienniku z separatorem FNC1 zapisanym jako znacznik GS.
FNC1
Znak funkcyjny kodów GS1, przesyłany przez skaner jako znak GS (ASCII 29); kończy pole o zmiennej długości.
Tryb awaryjny parsera
Odczyt pól według maksymalnych długości, gdy w kodzie brakuje separatora; kończy się ostrzeżeniem.
Symbolika
Rodzaj kodu kreskowego, np. GS1-128 albo GS1 DataMatrix, rozpoznawany po identyfikatorze symboliki dodawanym przez skaner.