Een app voor bestelinname bouwen
Koppel een gefilterde datasource, valideer een formulier voordat het wordt opgeslagen en toon in beide gevallen de juiste melding.
Een app voor bestelinname neemt een verzoek aan, controleert het voordat het wordt opgeslagen en laat de persoon weten of het gelukt is. Deze tutorial bouwt die opzet: een tabel, een wachtrij die alleen toont wat nog aandacht nodig heeft, een formulier dat weigert op te slaan zolang het niet klopt, en twee verschillende meldingen afhankelijk van wat er gebeurde. Reken op ongeveer 25 minuten.
Wat je gaat bouwen
- Een tabel Orders met een klant, een product, een aantal en een status.
- Een component Order Queue (Multi View) waarvan de datasource alleen op openstaande bestellingen is gefilterd.
- Een component Order Intake (Single View) met een formulier.
- Een opslagworkflow die controleert of het formulier is ingevuld voordat er iets wordt geschreven, met een foutmelding als dat niet zo is en een succesmelding als dat wel zo is.
Deze tutorial gaat uit van de opzet uit Een kleine CRM bouwen: een tabel, een Multi View-lijst, een Single View-formulier en een opslagworkflow. Ze besteedt minder tijd aan die basis en meer aan wat hier nieuw is: een gefilterde datasource en een workflow die vertakt.
Stap 1: De tabel Orders aanmaken
De tabel toevoegen
Klik in de boom links met de rechtermuisknop op Database, kies Aanmaken, zet Typen op
Tabel, kies een DBS-driver en noem hem ORD - Orders.
De velden toevoegen
Gebruik op het tabblad Velden Veld toevoegen voor: ORD_Order_Id (String, verplicht),
ORD_Customer_Name (String, verplicht), ORD_Product (String, verplicht), ORD_Quantity (Number,
verplicht), ORD_Status (String).
Een unieke index toevoegen
Voeg op het tabblad Indexen een index toe op ORD_Order_Id en zet Uniek aan.
Voorbeeldrijen toevoegen
Voeg op het tabblad Gegevens met de hand twee of drie bestellingen toe met verschillende waarden
voor ORD_Status, zodat de volgende stap iets heeft om te filteren.
Stap 2: De Order Queue bouwen met een gefilterde datasource
Het component toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Component,
Uitvoer op Multi View en noem het Order Queue.
De Datasource koppelen met een Query
Open het tabblad Datasource, kies DB-tabel, selecteer ORD - Orders en zet de filtermodus
op Query in plaats van Index. Voeg met de weergave Builder een regel toe: ORD_Status is
gelijk aan Pending. In tegenstelling tot de Contacts List van de CRM, die via een index elke rij
laadde, krijgt dit component alleen de rijen die aan de regel voldoen. Zie Componentdatasource.
De velden binnenhalen en een rij opmaken
Haal op het tabblad Velden ORD_Customer_Name, ORD_Product, ORD_Quantity en ORD_Status
binnen als Tabel-velden. Voeg op het tabblad UI een rij-element toe, selecteer het en zet
For-loop aan in de elementeigenschappen, zodat het zich herhaalt voor elke bestelling die nog
openstaat.
Een voorbeeld bekijken
Zet Live preview aan en controleer dat alleen de openstaande voorbeeldbestellingen verschijnen, niet degene die je met een andere status hebt gemarkeerd.
Stap 3: Het formulier Order Intake bouwen
Het component toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Component,
Uitvoer op Single View en noem het Order Intake.
De velden toevoegen
Voeg op het tabblad Velden ORD_Customer_Name, ORD_Product en ORD_Quantity toe als
Tabel-velden met ORD - Orders als bron. Laat ORD_Status van het formulier af. Die wordt door
de workflow in de volgende stap gezet en niet getypt door de persoon die de bestelling plaatst.
De invoervelden bouwen
Voeg op het tabblad UI een invoerveld toe voor elk van de drie velden, selecteer ze één voor één
en gebruik Binden in de elementeigenschappen om ze met xu-bind aan hun veld te koppelen.
Stap 4: De opslagworkflow aansluiten, met validatie
Een Set Data-programma toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Set Data en
noem het Save Order. Laat crudMode op C staan. Bind op het raster VeldenORD_Customer_Name, ORD_Product en ORD_Quantity als Tabel-velden, plus ORD_Status
eveneens als Tabel-veld. De waarde van dat laatste komt uit de workflowstap, niet uit het
formulier.
Twee Melding-programma's toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken en zet Typen op Melding.
Doe dat voor Order Saved (Typen Success, Weergave Toast, Titel "Order received", Inhoud "The order
was saved."). Het ongeldige geval laat je over aan een inline melding in de workflow zelf, dus daar
is geen apart programma voor nodig. Zie Melding.
De workflow van de knop Opslaan beginnen
Selecteer terug in Order Intake de knop Opslaan, open Workflows en bouw met Actie toevoegen:
Laadindicator aan (UI-hulpprogramma's), een inline Melding (UI-hulpprogramma's) voor het
ongeldige geval, Gegevens instellen (Database) gericht op Save Order met ORD_Status
gekoppeld aan de vaste waarde Pending, Melding aanroepen (UI-hulpprogramma's) gericht op
Order Saved en dan Laadindicator uit.
De melding voor het ongeldige geval voorwaardelijk maken
Klik met de rechtermuisknop op de inline stap Melding en kies Voorwaarde. Zet de expressie zo dat ze alleen waar is als het formulier onvolledig is, bijvoorbeeld een klantnaam, product of aantal dat nog leeg is. Vul de velden van de Melding inline in: Typen Error, Weergave Toast, Titel "Check the order", Inhoud "Fill in customer, product and quantity before saving."
De stap Gegevens instellen de tegenovergestelde voorwaarde geven
Klik met de rechtermuisknop op de stap Gegevens instellen, kies Voorwaarde en zet de expressie zo dat ze alleen waar is als het formulier compleet is, precies het tegenovergestelde van de voorwaarde van de stap Melding. Doe hetzelfde voor de stap Melding aanroepen daarna, zodat een opslagactie de succesmelding alleen bereikt als Gegevens instellen echt is uitgevoerd. Zie Events, Workflow voor wat Voorwaarde en Async bij een stap regelen.
Gebruik het selectievakje bij een workflowstap om hem tijdelijk uit te zetten. Zet de stappen van het geldige pad uit terwijl je controleert of de foutmelding goed afgaat bij een leeg veld, en zet ze daarna weer aan.
Stap 5: Er een pagina van maken
Een Route toevoegen
Klik met de rechtermuisknop op Routes, kies Aanmaken en noem hem Orders. Voeg een
menu-item met de titel "Queue" toe dat naar Order Queue verwijst en stel het in als
standaardmenu-item. Voeg dan een tweede item toe met de titel "New Order" dat naar Order Intake
verwijst.
De inname koppelen aan de wachtrij
Selecteer een element "Nieuwe bestelling" op Order Queue en geef het een workflow: Actie
toevoegen > Navigatie > Pagina aanroepen, gericht op Order Intake.
Controleer het
Zet Live preview aan. Probeer eerst het formulier Order Intake leeg op te slaan, controleer dat
de foutmelding (toast) verschijnt en dat er niets wordt geschreven. Vul dan alle drie de velden in,
sla op, controleer dat de succesmelding (toast) verschijnt en dat de bestelling met de status
Pending in de Order Queue staat.