Zbuduj aplikację do przyjmowania zamówień
Połącz filtrowane źródło danych, zwaliduj formularz przed zapisem i pokaż właściwy alert w obu przypadkach.
Aplikacja do przyjmowania zamówień przyjmuje zgłoszenie, sprawdza je przed zapisem i informuje użytkownika, czy się udało. Ten samouczek buduje taki kształt: tabelę, kolejkę pokazującą tylko to, co nadal wymaga uwagi, formularz, który odmawia zapisu, dopóki dane nie mają sensu, oraz dwa różne alerty zależnie od tego, co się stało. Zaplanuj około 25 minut.
Co zbudujesz
- Tabelę Orders z klientem, produktem, ilością i statusem.
- Komponent Order Queue (Multi View), którego źródło danych jest przefiltrowane tylko do zamówień oczekujących.
- Komponent Order Intake (Single View) z formularzem.
- Przepływ zapisu, który sprawdza, czy formularz jest wypełniony, zanim cokolwiek zapisze, pokazuje alert błędu, gdy nie jest, i alert sukcesu, gdy jest.
Ten samouczek zakłada kształt z Zbuduj małe CRM: tabelę, listę Multi View, formularz Single View i przepływ zapisu. Mniej czasu poświęca tym podstawom, a więcej nowym tutaj elementom: filtrowanemu źródłu danych i przepływowi, który się rozgałęzia.
Krok 1: Utwórz tabelę Orders
Dodaj tabelę
W lewym drzewie kliknij prawym przyciskiem Database, wybierz Utwórz, ustaw Wpisz na
Tabela, wybierz Sterownik DBS i nazwij tabelę ORD - Orders.
Dodaj pola
Na zakładce Pola użyj Dodaj pole dla: ORD_Order_Id (String, obowiązkowe), ORD_Customer_Name
(String, obowiązkowe), ORD_Product (String, obowiązkowe), ORD_Quantity (Number, obowiązkowe),
ORD_Status (String).
Dodaj unikalny indeks
Na zakładce Indeksy dodaj indeks na ORD_Order_Id i włącz Unikalne.
Dodaj przykładowe wiersze
Na zakładce Dane dodaj ręcznie dwa lub trzy zamówienia z różnymi wartościami ORD_Status, żeby
następny krok miał co filtrować.
Krok 2: Zbuduj Order Queue z filtrowanym źródłem danych
Dodaj komponent
Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Komponent, Wyjście Widok wielokrotny,
nazwij go Order Queue.
Połącz źródło danych przez zapytanie
Otwórz zakładkę Źródło danych, wybierz Tabela bazy danych, wskaż ORD - Orders i ustaw tryb
filtra na Zapytanie zamiast Indeks. W widoku Builder dodaj regułę: ORD_Status równa się
Pending. W przeciwieństwie do listy Contacts List z CRM, która wczytywała każdy wiersz przez indeks,
ten komponent dostaje tylko wiersze pasujące do reguły. Zobacz
Źródło danych komponentu.
Przenieś pola i ułóż wiersz
Na zakładce Pola dodaj ORD_Customer_Name, ORD_Product, ORD_Quantity i ORD_Status jako pola
typu Tabela. Na zakładce UI dodaj element wiersza, zaznacz go i włącz Pętla for we
właściwościach elementu, aby powtarzał się raz na każde nadal oczekujące zamówienie.
Podejrzyj
Włącz Podgląd na żywo i sprawdź, czy pojawiają się tylko oczekujące przykładowe zamówienia, a nie te, które oznaczyłeś innym statusem.
Krok 3: Zbuduj formularz Order Intake
Dodaj komponent
Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Komponent, Wyjście Widok pojedynczy,
nazwij go Order Intake.
Dodaj jego pola
Na zakładce Pola dodaj ORD_Customer_Name, ORD_Product i ORD_Quantity jako pola typu Tabela
ze źródłem ORD - Orders. Pomiń ORD_Status w formularzu. Ustawia go przepływ w następnym kroku, a nie
osoba składająca zamówienie.
Zbuduj pola wprowadzania
Na zakładce UI dodaj pole wprowadzania dla każdego z trzech pól, zaznacz każde i użyj Powiąż we
właściwościach elementu, aby połączyć je z jego polem przez xu-bind.
Krok 4: Podłącz przepływ zapisu z walidacją
Dodaj program Set Data
Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Set Data, nazwij go Save Order. Zostaw
crudMode na C. W jego siatce Pola powiąż ORD_Customer_Name, ORD_Product i ORD_Quantity
jako pola typu Tabela, a także ORD_Status również jako pole typu Tabela. Wartość tego ostatniego
pochodzi z kroku przepływu, a nie z formularza.
Dodaj dwa programy Alert
Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Alert, dwukrotnie: Order Saved (Wpisz
Success, Wyświetlanie Toast, Tytuł "Order received", Treść "The order was saved.") i zostaw przypadek
niepoprawnych danych dla alertu wbudowanego w sam przepływ, więc nie potrzebuje osobnego programu. Zobacz
Alert.
Zacznij przepływ przycisku Zapisz
Wróć do Order Intake, zaznacz przycisk Zapisz, otwórz Przepływy pracy i użyj Dodaj akcję, aby
zbudować: Włącz wskaźnik ładowania (Narzędzia UI), wbudowany Alert (Narzędzia UI) dla przypadku
niepoprawnych danych, Ustaw dane (Baza danych) wskazujące Save Order, z ORD_Status zmapowanym na
stałą wartość Pending, Wywołaj alert (Narzędzia UI) wskazujący Order Saved, a na końcu Wyłącz
wskaźnik ładowania.
Uzależnij alert dla niepoprawnych danych od warunku
Kliknij prawym przyciskiem wbudowany krok Alert i wybierz Warunek. Ustaw jego wyrażenie tak, by było prawdziwe tylko wtedy, gdy formularz jest niekompletny, na przykład gdy nazwa klienta, produkt lub ilość są nadal puste. Uzupełnij jego pola Alert w miejscu: Wpisz Error, Wyświetlanie Toast, Tytuł "Check the order", Treść "Fill in customer, product and quantity before saving."
Ustaw w kroku Set Data warunek przeciwny
Kliknij prawym przyciskiem krok Ustaw dane, wybierz Warunek i ustaw jego wyrażenie tak, by było prawdziwe tylko wtedy, gdy formularz jest kompletny, czyli dokładnie odwrotnie niż warunek kroku Alert. To samo zrób dla następującego po nim kroku Wywołaj alert, aby zapis dochodził do alertu sukcesu tylko wtedy, gdy Set Data rzeczywiście się wykonał. Zobacz Zdarzenia i przepływ pracy, aby dowiedzieć się, co w kroku kontrolują Condition i Async.
Użyj pola wyboru przy kroku przepływu, aby tymczasowo go wyłączyć. Wyłącz kroki poprawnej ścieżki, gdy sprawdzasz, czy alert błędu uruchamia się prawidłowo przy pustym polu, a potem włącz je z powrotem.
Krok 5: Zrób z tego stronę
Dodaj trasę
Kliknij prawym przyciskiem Trasy, Utwórz, nazwij ją Orders. Dodaj pozycję menu o tytule "Queue"
wskazującą Order Queue i ustaw ją jako domyślną pozycję menu, a potem drugą pozycję o tytule "New
Order" wskazującą Order Intake.
Połącz przyjmowanie z kolejką
Zaznacz element "New order" w Order Queue i nadaj mu przepływ pracy: Dodaj akcję > Navigation >
Wywołaj stronę, wskazujący Order Intake.
Sprawdź
Włącz Podgląd na żywo. Najpierw spróbuj zapisać pusty formularz Order Intake i sprawdź, że pojawia
się toast z błędem i nic się nie zapisuje. Potem wypełnij wszystkie trzy pola, zapisz, sprawdź, że
pojawia się toast sukcesu, a zamówienie trafia do Order Queue ze statusem Pending.