Construiește o aplicație de preluare a comenzilor
Conectezi o sursă de date filtrată, validezi un formular înainte de salvare și afișezi alerta potrivită în ambele cazuri.
O aplicație de preluare a comenzilor primește o cerere, o verifică înainte de salvare și îi spune persoanei dacă a funcționat. Acest tutorial construiește exact această structură: un tabel, o coadă care arată doar ce are încă nevoie de atenție, un formular care refuză să salveze până când are sens și două alerte diferite, în funcție de ce s-a întâmplat. Rezervă-ți cam 25 de minute.
Ce vei construi
- Un tabel Comenzi cu un client, un produs, o cantitate și o stare.
- O componentă Order Queue (Vizualizare multiplă) a cărei sursă de date este filtrată doar pe comenzile în așteptare.
- O componentă Order Intake (Vizualizare unică) cu un formular.
- Un flux de salvare care verifică dacă formularul este completat înainte să scrie ceva, o alertă de eroare când nu este și o alertă de succes când este.
Acest tutorial pornește de la structura din Construiește un CRM mic: un tabel, o listă în Vizualizare multiplă, un formular în Vizualizare unică și un flux de salvare. Petrece mai puțin timp pe aceste noțiuni de bază și mai mult pe părțile noi: o sursă de date filtrată și un flux de lucru care se ramifică.
Pasul 1: Creează tabelul Comenzi
Adaugă tabelul
În arborele din stânga, fă clic dreapta pe Bază de date, alege Creează, setează Tip pe
Tabel, alege un Driver DBS și numește-l ORD - Orders.
Adaugă câmpurile
În fila Câmpuri, folosește Adaugă câmp pentru: ORD_Order_Id (String, obligatoriu),
ORD_Customer_Name (String, obligatoriu), ORD_Product (String, obligatoriu), ORD_Quantity
(Number, obligatoriu), ORD_Status (String).
Adaugă un index unic
În fila Indecși, adaugă un index pe ORD_Order_Id și activează Unic.
Adaugă rânduri de probă
În fila Date, adaugă manual două sau trei comenzi cu valori diferite pentru ORD_Status, ca
pasul următor să aibă ce filtra.
Pasul 2: Construiește Order Queue cu o sursă de date filtrată
Adaugă componenta
Fă clic dreapta pe Programe, Creează, Tip Componentă, Ieșire Vizualizare multiplă,
numește-o Order Queue.
Conectează sursa de date cu o interogare
Deschide fila Sursă de date, alege Tabel bază de date, selectează ORD - Orders și setează
modul de filtrare pe Interogare în loc de Index. Folosește vizualizarea Constructor ca să
adaugi o regulă: ORD_Status este egal cu Pending. Spre deosebire de Contacts List din CRM, care
încărca fiecare rând printr-un index, această componentă primește doar rândurile care se potrivesc
regulii. Vezi Sursa de date a componentei.
Adu câmpurile și aranjează un rând
În fila Câmpuri, adu ORD_Customer_Name, ORD_Product, ORD_Quantity și ORD_Status ca
câmpuri de tip Tabel. În fila UI, adaugă un element de tip rând, selectează-l și activează
Buclă For în proprietățile elementului, ca să se repete o dată pentru fiecare comandă încă în
așteptare.
Previzualizează
Activează Previzualizare live și confirmă că apar doar comenzile de probă în așteptare, nu cele pe care le-ai marcat cu altă stare.
Pasul 3: Construiește formularul Order Intake
Adaugă componenta
Fă clic dreapta pe Programe, Creează, Tip Componentă, Ieșire Vizualizare unică,
numește-o Order Intake.
Adaugă câmpurile ei
În fila Câmpuri, adaugă ORD_Customer_Name, ORD_Product și ORD_Quantity ca și câmpuri de
tip Tabel cu sursa ORD - Orders. Lasă ORD_Status în afara formularului. Este setat de fluxul
de lucru din pasul următor, nu scris de persoana care plasează comanda.
Construiește intrările
În fila UI, adaugă o intrare pentru fiecare dintre cele trei câmpuri, selectează fiecare intrare
și folosește Leagă în proprietățile elementului ca să o conectezi de câmpul ei cu xu-bind.
Pasul 4: Conectează fluxul de salvare, cu validare
Adaugă un program Setează date
Fă clic dreapta pe Programe, Creează, Tip Setează date, numește-l Save Order. Lasă
crudMode pe C. În grila lui Câmpuri, leagă ORD_Customer_Name, ORD_Product și
ORD_Quantity ca și câmpuri de tip Tabel, plus ORD_Status, tot ca și câmp de tip Tabel,
valoarea acestuia din urmă vine din pasul fluxului de lucru, nu din formular.
Adaugă două programe Alertă
Fă clic dreapta pe Programe, Creează, Tip Alertă de două ori: Order Saved (Tip Succes,
Afișare Toast, Titlu „Comandă primită”, Conținut „Comanda a fost salvată.”) și lasă cazul invalid
pentru o alertă inline chiar în fluxul de lucru, astfel încât să nu aibă nevoie de un program
separat. Vezi Alertă.
Începe fluxul de lucru al butonului Salvează
Înapoi în Order Intake, selectează butonul Salvează, deschide Fluxuri de lucru și folosește
Adaugă acțiune ca să construiești: Activează indicatorul de încărcare (Utilitare UI), o
Alertă inline (Utilitare UI) pentru cazul invalid, Setează date (Bază de date) îndreptat spre
Save Order, cu ORD_Status mapat pe valoarea fixă Pending, Apelează alertă (Utilitare UI)
îndreptat spre Order Saved, apoi Dezactivează indicatorul de încărcare.
Fă alerta cazului invalid condiționată
Fă clic dreapta pe pasul Alertă inline și alege Condiție. Setează expresia să fie adevărată doar când formularul este incomplet, de exemplu un nume de client, un produs sau o cantitate care sunt încă goale. Completează inline câmpurile Alertă: Tip Eroare, Afișare Toast, Titlu „Verifică comanda”, Conținut „Completează clientul, produsul și cantitatea înainte de salvare.”
Fă pasul Setează date să aibă condiția opusă
Fă clic dreapta pe pasul Setează date, alege Condiție și setează expresia să fie adevărată doar când formularul este complet, exact opusul condiției pasului Alertă. Fă la fel pentru pasul Apelează alertă de după el, ca o salvare să ajungă la alerta de succes doar când Setează date a rulat cu adevărat. Vezi Evenimente, flux de lucru pentru ce controlează Condiție și Async pe un pas.
Folosește caseta de bifare de pe un pas al fluxului de lucru ca să-l dezactivezi temporar. Oprește pașii căii valide cât verifici dacă alerta de eroare se declanșează corect pe un câmp gol, apoi pornește-i la loc.
Pasul 5: Transformă-l într-o pagină
Adaugă o Rută
Fă clic dreapta pe Rute, Creează, numește-o Orders. Adaugă un element de meniu cu titlul
„Coadă” îndreptat spre Order Queue și setează-l ca element de meniu implicit, apoi un al doilea
element cu titlul „Comandă nouă” îndreptat spre Order Intake.
Leagă preluarea comenzii de coadă
Selectează un element „Comandă nouă” din Order Queue și dă-i un flux de lucru: Adaugă acțiune >
Navigare > Apelează pagină, îndreptat spre Order Intake.
Verifică
Activează Previzualizare live. Încearcă mai întâi să salvezi formularul Order Intake gol,
confirmă că apare toast-ul de eroare și că nu se scrie nimic. Apoi completează toate cele trei
câmpuri, salvează, confirmă că apare toast-ul de succes și că
comanda apare în Order Queue cu starea Pending.