Sari la conținut
Verificat

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.
Continuare după tutorialul CRM

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.

Testează o ramură pe rând

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.

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.