Byg en ordremodtagelses-app
Forbind en filtreret datakilde, validér en formular, før den gemmer, og vis den rigtige alarm i begge tilfælde.
En ordremodtagelses-app tager imod en anmodning, tjekker den, før den gemmes, og fortæller brugeren, om det lykkedes. Denne vejledning bygger den form: en tabel, en kø der kun viser det, der stadig kræver opmærksomhed, en formular, der nægter at gemme, før det giver mening, og to forskellige alarmer afhængigt af, hvad der skete. Afsæt omkring 25 minutter.
Det her bygger du
- En tabel Orders med en kunde, et produkt, en mængde og en status.
- En komponent Order Queue (Multi View), hvis datakilde er filtreret til kun afventende ordrer.
- En komponent Order Intake (Single View) med en formular.
- En gemmearbejdsgang, der tjekker, at formularen er udfyldt, før den skriver noget, en fejlalarm, når den ikke er, og en succesalarm, når den er.
Denne vejledning forudsætter formen fra Byg et lille CRM: en tabel, en Multi View-liste, en Single View-formular og en gemmearbejdsgang. Den bruger mindre tid på det grundlæggende og mere på det, der er nyt her: en filtreret datakilde og en arbejdsgang, der forgrener sig.
Trin 1: Opret tabellen Orders
Tilføj tabellen
Højreklik på Database i træet til venstre, vælg Opret, sæt Type til Tabel, vælg en
DBS-driver, og navngiv den ORD - Orders.
Tilføj felterne
Brug Tilføj felt på fanen Felter til: ORD_Order_Id (String, obligatorisk),
ORD_Customer_Name (String, obligatorisk), ORD_Product (String, obligatorisk), ORD_Quantity
(Number, obligatorisk), ORD_Status (String).
Tilføj et unikt indeks
Tilføj et indeks på ORD_Order_Id på fanen Indekser, og slå Unik til.
Tilføj eksempelrækker
Tilføj to eller tre ordrer i hånden med forskellige ORD_Status-værdier på fanen Data, så
næste trin har noget at filtrere.
Trin 2: Byg Order Queue med en filtreret datakilde
Tilføj komponenten
Højreklik på Programmer, Opret, Type Komponent, Output Multi View, og navngiv den
Order Queue.
Forbind datakilden med en forespørgsel
Åbn fanen Datakilde, vælg DB-tabel, vælg ORD - Orders, og sæt filtertilstanden til
Forespørgsel i stedet for Indeks. Brug visningen Bygger til at tilføje en regel:
ORD_Status er lig med Pending. I modsætning til CRM'ets Contacts List, der indlæste alle rækker
gennem et indeks, får denne komponent kun de rækker, der matcher reglen. Se
Komponentens datakilde.
Hent felterne ind og læg en række ud
Hent ORD_Customer_Name, ORD_Product, ORD_Quantity og ORD_Status ind som Tabel-felter på
fanen Felter. Tilføj et rækkeelement på fanen UI, markér det, og slå For-løkke til i
Elementegenskaber, så det gentages én gang pr. ordre, der stadig afventer.
Se et eksempel
Slå Live-forhåndsvisning til, og kontrollér, at kun de afventende eksempelordrer dukker op, ikke dem, du markerede med en anden status.
Trin 3: Byg formularen Order Intake
Tilføj komponenten
Højreklik på Programmer, Opret, Type Komponent, Output Single View, og navngiv den
Order Intake.
Tilføj dens felter
Tilføj ORD_Customer_Name, ORD_Product og ORD_Quantity som Tabel-felter fra
ORD - Orders på fanen Felter. Lad ORD_Status stå uden for formularen. Den sættes af
arbejdsgangen i næste trin og indtastes ikke af den, der afgiver ordren.
Byg inputfelterne
Tilføj et inputfelt for hvert af de tre felter på fanen UI, markér hvert enkelt, og brug
Bind i Elementegenskaber til at forbinde det med dets felt via xu-bind.
Trin 4: Forbind gemmearbejdsgangen med validering
Tilføj et Set Data-program
Højreklik på Programmer, Opret, Type Set Data, og navngiv det Save Order. Lad
crudMode stå på C. Bind ORD_Customer_Name, ORD_Product og ORD_Quantity som
Tabel-felter i dets Felter-gitter, plus ORD_Status også som et Tabel-felt. Værdien
til det sidste kommer fra arbejdsgangstrinnet, ikke fra formularen.
Tilføj to Alert-programmer
Højreklik på Programmer, Opret, Type Alert to gange: Order Saved (Type Success,
Visning Toast, Titel "Order received", Indhold "The order was saved.") og lad det ugyldige tilfælde
være en indlejret alarm i selve arbejdsgangen, så det ikke behøver et eget program. Se
Alert.
Start arbejdsgangen for knappen Gem
Tilbage i Order Intake markerer du knappen Gem, åbner Arbejdsgange og bruger Tilføj handling
til at bygge: Loader til (UI-værktøjer), en indlejret Alert (UI-værktøjer) til det ugyldige
tilfælde, Sæt data (Database) rettet mod Save Order, hvor ORD_Status er koblet til den faste
værdi Pending, Kald alarm (UI-værktøjer) rettet mod Order Saved og til sidst Loader fra.
Gør alarmen for det ugyldige tilfælde betinget
Højreklik på det indlejrede Alert-trin, og vælg Betingelse. Sæt dets udtryk til kun at være sandt, når formularen er ufuldstændig, for eksempel et kundenavn, et produkt eller en mængde, der stadig er tom. Udfyld dets Alert-felter direkte: Type Error, Visning Toast, Titel "Check the order", Indhold "Fill in customer, product and quantity before saving."
Gør Set Data-trinnet til den modsatte betingelse
Højreklik på Set Data-trinnet, vælg Betingelse, og sæt dets udtryk til kun at være sandt, når formularen er komplet, det præcise modsatte af Alert-trinnets betingelse. Gør det samme for trinnet Kald alarm efter det, så en gem kun når frem til succesalarmen, når Set Data faktisk kørte. Se Events, Workflow for, hvad Betingelse og Async styrer på et trin.
Brug afkrydsningsfeltet på et arbejdsgangstrin til at deaktivere det midlertidigt. Slå trinnene på den gyldige sti fra, mens du tjekker, at fejlalarmen udløses korrekt ved et tomt felt, og slå dem så til igen.
Trin 5: Gør det til en side
Tilføj en Route
Højreklik på Ruter, Opret, og navngiv den Orders. Tilføj et menupunkt med titlen "Queue"
rettet mod Order Queue, og sæt det som standardmenupunkt, derefter et andet punkt med titlen "New
Order" rettet mod Order Intake.
Link til modtagelsen fra køen
Markér et element "New order" på Order Queue, og giv det en arbejdsgang: Tilføj handling >
Navigation > Kald side, rettet mod Order Intake.
Tjek det
Slå Live-forhåndsvisning til. Prøv først at gemme formularen Order Intake tom, kontrollér, at
fejltoasten dukker op, og at intet bliver skrevet. Udfyld så alle tre felter, gem, og kontrollér, at
succestoasten dukker op, og at ordren vises i Order Queue med status Pending.