# Błąd w formularzu WMS: komunikat przy polu i dźwięk > Jak formularz WMS zgłasza błąd: komunikat przy polu, plik dźwiękowy albo sygnał domyślny i słownik tłumaczeń fraz. Przykłady komunikatów z przyjęcia i wydania. Adres strony: https://magazyn.softwarestudio.com.pl/komunikaty-bledow-w-wms-tekst-dzwiek-i-slownik/ --- W opisywanym projekcie błąd w formularzu WMS ma jedno miejsce i dwa sygnały: komunikat przy polu oraz dźwięk. Dźwięk to plik dedykowany albo sygnał domyślny, a tekst przechodzi przez słownik tłumaczeń. Formularze odwołują się do siedmiu plików dźwiękowych, z których sześć jest używanych. Walidacja w formularzu WMS kończy się komunikatem, ale w opisywanym wdrożeniu komunikat ma towarzysza: dźwięk. Poniżej pokazujemy, jak formularz wskazuje błędne pole, które sytuacje mają własny plik dźwiękowy i jak teksty przechodzą przez słownik. Opisujemy formularze dedykowane tego wdrożenia na platformie [Studio WMS.net](/wms/). Dokumenty, które sprawdzają, opisują artykuły o [przyjęciu PZ ze zlecenia](https://system.wms.net.pl/przyjecie-pz-ze-zlecenia-formularz-bez-zbednych-pol/) i o [wydaniu WZ ze zlecenia](https://system.wms.net.pl/wydanie-wz-ze-zlecenia-przycisk-generuj/), a ich budowę uzgodniono w [specyfikacji formularzy w arkuszu](/specyfikacja-formularzy-wms-w-arkuszu/). Typy dokumentów omawia strona o [dokumentach magazynowych](/dokumenty-magazynowe/). Tekst obejmuje też to, czego dźwięk i słownik nie obejmują, oraz pytania, które zadajemy na etapie analizy. Zdania o liczbie plików i o podziale na formularze opisują stan opisywanego wdrożenia, a nie standard platformy. ## Błąd wskazuje pole Wywołanie błędu przyjmuje pole i tekst, a plik dźwiękowy można podać dodatkowo. Kliknięcie Dalej albo Zapisz uruchamia kontrole pól i ilości. Gdy kontrola nie przechodzi, formularz zatrzymuje się na błędnym polu i pokazuje przy nim komunikat ze słownika. Komunikat pojawia się w dymku przy polu, a pole dostaje fokus. Dymek znika po trzech sekundach. Gdy wywołanie nie podaje pliku dźwiękowego, formularz odtwarza sygnał domyślny, więc każdy komunikat zgłoszony tą drogą ma dźwięk. ## Siedem plików dźwiękowych, sześć używanych Formularze odwołują się do siedmiu plików dźwiękowych. Sześć z nich jest osiągalnych w formularzach, a siódmy dotyczy pola, które jest tam ukryte. Tabela zestawia sześć sytuacji z dźwiękiem dedykowanym i dwie z sygnałem domyślnym. | Sytuacja | Komunikat (przykład) | Dźwięk | | --- | --- | --- | | Nie wybrano kontrahenta | wybierz kontrahenta | plik dedykowany | | Nie wybrano zlecenia | wybierz zlecenie | plik dedykowany | | Brak daty | podaj datę | plik dedykowany | | Brak stanu dla pozycji | Brak stanów dla wybranej pozycji. | plik dedykowany | | Za duża ilość w wydaniu | Przekroczona ilość dostępna do wydania. | plik dedykowany | | Dokument bez pozycji | Brak pozycji dokumentu | plik dedykowany | | Za duża ilość w przyjęciu | Przekroczona ilość przyjęcia (X) niż na zleceniu ZPZ (Y) | sygnał domyślny | | Nie wybrano dostawcy | wybierz dostawcę | sygnał domyślny | Komunikat o przekroczeniu ilości w przyjęciu PZ nie ma więc własnego pliku, choć ma go analogiczny komunikat w wydaniu WZ. Plik dźwiękowy komunikatu „Brak pozycji dokumentu” gra też przy komunikacie o zapisaniu daty. ## Które formularze mają dźwięki dedykowane Dźwięki dedykowane mają głównie formularze przyjęcia PZ i wydania WZ oraz ich warianty. Tabela pokazuje podział według typu formularza. | Formularz | Dźwięki dedykowane | | --- | --- | | Przyjęcie PZ i warianty | pięć: wybór kontrahenta, wybór zlecenia, data, brak stanu i brak pozycji dokumentu | | Wydanie WZ i warianty | sześć: te same pięć oraz przekroczona ilość | | Zwrot sprzętu | dwa: wybór kontrahenta i brak stanu | | Wypożyczenie, RW i MM | w praktyce jeden plik, przy komunikacie o dacie | | Zlecenia | żaden, komunikaty grają sygnał domyślny | Kopię formularza dla drugiego działu klienta opisuje artykuł o [wariancie formularza](/wariant-formularza-dla-drugiego-dzialu-klienta/), który zmienia etykiety, ale zostawia kontrole ilości. ## To samo zdanie, inne znaczenie Komunikat „Brak stanów dla wybranej pozycji.” występuje w kilku formularzach, ale nie znaczy wszędzie tego samego: - W przyjęciu PZ i zwrocie: zlecenie nie ma pozycji do realizacji. - W wydaniu WZ: w wybranej lokalizacji nie ma stanu dla pozycji. W wydaniu RW, w wypożyczeniu, w przesunięciu MM i w zleceniu zwrotu ten sam tekst gra sygnał domyślny, a nie plik dedykowany. Przy analizie komunikatów trzeba więc sprawdzić formularz, w którym komunikat się pojawia, i dopiero potem jego treść. Przykład (dane fikcyjne): dwóch użytkowników zgłasza ten sam komunikat „Brak stanów dla wybranej pozycji.”. Pierwszy przyjmuje towar ze zlecenia ZPZ-26-0001 i dostaje komunikat, bo zlecenie nie ma pozycji do realizacji. Drugi wydaje towar z lokalizacji, w której nie ma stanu dla wybranej pozycji. Zanim szukamy przyczyny, pytamy więc, w którym formularzu komunikat się pojawił. ## Komunikat z liczbami zamiast ogólnika Komunikat o ilości w przyjęciu podaje dwie liczby: wpisaną i dopuszczalną. Taki komunikat mają trzy formularze przyjęć: PZ, zwrotu i przyjęcia MM. W przyjęciu PZ dopuszczalną liczbą jest ilość pozostała na zleceniu ZPZ, a w przyjęciu MM ilość z wydania. > „Przekroczona ilość przyjęcia (X) niż na zleceniu ZPZ (Y)” - przykład komunikatu z formularza przyjęcia PZ, w którym stoją obie liczby: wpisana i dopuszczalna. | Formularz | Liczby w komunikacie | Brzmienie | | --- | --- | --- | | Przyjęcie PZ | dwie: wpisana i dopuszczalna | Przekroczona ilość przyjęcia (X) niż na zleceniu ZPZ (Y) | | Zwrot | dwie | Przekroczona ilość przyjęcia (X) na zleceniu jest (Y) | | Przyjęcie MM | dwie | Przekroczona ilość przyjęcia (X) niż na wydaniu (Y) | | Zlecenie zwrotu | jedna | Ilość do zwrotu: X | | Wydanie WZ | brak | Przekroczona ilość dostępna do wydania. | Przykład (dane fikcyjne): zlecenie ZPZ-26-0001 ma pozostałe 100 sztuk indeksu WYR-001, a użytkownik wpisuje 120. Komunikat podaje wtedy obie wartości, wpisaną i pozostałą na zleceniu, więc użytkownik widzi limit bez otwierania dokumentu. Przykład (dane fikcyjne): w zleceniu zwrotu dla indeksu SPRZ-001 użytkownik wpisuje ilość wyższą od dopuszczalnej. Komunikat „Ilość do zwrotu: X” podaje wtedy jedną liczbę, czyli ilość, którą można zwrócić, a nie wpisaną wartość. Wydanie WZ w tej samej sytuacji mówi tylko o przekroczeniu, więc liczby trzeba sprawdzić w dokumencie. Komunikat o przekroczeniu składa się z trzech fragmentów tłumaczonych osobno. Liczby stoją między fragmentami tekstu, więc tłumaczenie obejmuje fragmenty, a nie całe zdanie. ## Słownik fraz w formularzach Prawie wszystkie etykiety i przyciski formularzy przechodzą przez słownik tłumaczeń. Fraza jest dopasowywana małymi literami. Gdy dla frazy brakuje tłumaczenia, formularz pokazuje oryginał polski. Część potwierdzeń w formularzu zwrotu, przycisk przeniesienia do bufora w zleceniu zwrotu i okno edycji pozycji słownika nie używają. Te teksty zostają w brzmieniu z formularza. Ogólne zasady wielojęzycznego interfejsu opisuje strona o [obsłudze wielu języków w WMS.net](/multi-language/). ## Komunikaty z sygnałem domyślnym Każdy komunikat zgłoszony przez formularz ma dźwięk. Podział jest prosty: - Plik dedykowany: sześć sytuacji z tabeli, na przykład brak stanu albo przekroczona ilość w wydaniu. - Sygnał domyślny: komunikaty bez własnego pliku, na przykład „wybierz dostawcę” i przekroczenie ilości w przyjęciu. Bez dźwięku są wyłącznie podpowiedzi pól wymaganych. Dla działu IT wynika z tego, że nowy komunikat dostaje dźwięk bez dodatkowej pracy, a dedykowany plik trzeba przypisać świadomie. ## Czego dźwięk i słownik nie obejmują Dźwięk towarzyszy komunikatowi, ale go nie zastępuje: treść błędu zawsze stoi w dymku przy polu. Podpowiedzi pól wymaganych dźwięku nie mają, a formularze zleceń nie odwołują się do żadnego z plików dedykowanych. Słownik nie obejmuje części potwierdzeń ani okna edycji pozycji. Nie opisujemy brzmienia dźwięków ani warunków ich odtwarzania, bo tych elementów nie ma w opisie wdrożenia. Opis dotyczy formularzy dedykowanych w opisywanym wdrożeniu, a nie każdego formularza platformy. Dźwięk dedykowany nie zmienia reguły kontroli. Kontrola przechodzi albo nie przechodzi niezależnie od tego, który plik gra, a sygnał domyślny pełni wobec użytkownika tę samą rolę ostrzeżenia co plik dedykowany. ## Pytania do zadania na etapie analizy Poniższe pytania nie są faktami o kliencie. To lista rzeczy, które zadajemy w [analizie przedwdrożeniowej](/analiza-przedwdrozeniowa-wms-co-zawiera/), zanim ktoś zdecyduje, jak mają brzmieć komunikaty: - Dźwięk: które kontrole mają mieć własny plik, a które zostają przy sygnale domyślnym? - Liczby: w których komunikatach użytkownik powinien zobaczyć limit obok wpisanej wartości? - Słownik: czy frazy dedykowane formularzy, na przykład osoba zlecająca albo nazwa imprezy, mają wpisy w słowniku? - Zlecenia: czy formularze zleceń zostają przy sygnale domyślnym, skoro nie odwołują się do plików? Odpowiedzi rozstrzygają, czy trzeba dopisać pliki dźwiękowe albo wpisy do słownika, zanim formularze trafią do użytkowników. ## Pytania i odpowiedzi o komunikatach błędów ## Słownik pojęć o komunikatach błędów Terminy używane przez dział IT i kierownika projektu, gdy formularz WMS zgłasza błąd tekstem i dźwiękiem.