W skrócie
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. Dokumenty, które sprawdzają, opisują artykuły o przyjęciu PZ ze zlecenia i o wydaniu WZ ze zlecenia, a ich budowę uzgodniono w specyfikacji formularzy w arkuszu. Typy dokumentów omawia strona o dokumentach magazynowych.
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, 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.
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, 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
Jak formularz pokazuje, które pole jest błędne?
Wywołanie błędu przyjmuje pole i tekst. Formularz zatrzymuje się na błędnym polu i pokazuje przy nim komunikat ze słownika w dymku, a pole dostaje fokus.
Ile plików dźwiękowych używa formularz?
Formularze odwołują się do siedmiu plików dźwiękowych, z których sześć jest używanych. Siódmy dotyczy pola ukrytego w formularzach.
Czy każdy komunikat ma dźwięk?
Tak, każdy komunikat zgłoszony przez formularz gra dedykowany plik albo sygnał domyślny. Bez dźwięku są tylko podpowiedzi pól wymaganych.
Jak działa słownik tłumaczeń?
Prawie wszystkie etykiety i przyciski formularzy przechodzą przez słownik fraz. Część potwierdzeń i okno edycji pozycji słownika nie używają.
Co się dzieje, gdy brakuje tłumaczenia frazy?
Formularz pokazuje oryginał polski, więc komunikat nadal się wyświetla. Komunikat o przekroczeniu ilości składa się z fragmentów tłumaczonych osobno.
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.
- Komunikat walidacyjny
- Tekst pokazany przy polu, gdy kontrola formularza nie przechodzi. Wywołanie błędu przyjmuje pole i tekst, a dźwięk jest opcjonalnym argumentem.
- Słownik tłumaczeń
- Zbiór fraz z ich tłumaczeniami, przez który przechodzą prawie wszystkie etykiety i przyciski. Brak tłumaczenia pokazuje oryginał polski.
- Plik dźwiękowy
- Plik odtwarzany razem z komunikatem. Formularze odwołują się do siedmiu takich plików, z których sześć jest używanych.
- Sygnał domyślny
- Dźwięk odtwarzany, gdy komunikat nie ma własnego pliku dedykowanego. Gra go na przykład komunikat „wybierz dostawcę”.
- Pole wymagane
- Pole, bez którego formularz nie zapisze dokumentu. Podpowiedzi pól wymaganych są jedynymi komunikatami bez dźwięku.
- Kontrola ilości
- Sprawdzenie, czy wpisana ilość mieści się w dopuszczalnej. W przyjęciach komunikat podaje obie liczby, a w wydaniu WZ mówi tylko o przekroczeniu.
- Dymek komunikatu
- Okienko przy polu, w którym formularz pokazuje tekst błędu. Pole dostaje fokus, a dymek znika po trzech sekundach.
Opisz nam komunikaty w swoich formularzach
Podaj, które kontrole mają sygnalizować błąd dźwiękiem, a omówimy teksty komunikatów i słownik fraz.
