Naar de inhoud springen
Geverifieerd

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.
Verder na de CRM-tutorial

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.

Test één tak tegelijk

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.

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.