Bygg en app för orderregistrering
Anslut en filtrerad datakälla, validera ett formulär innan det sparas och visa rätt varning i båda fallen.
En app för orderregistrering tar emot en förfrågan, kontrollerar den innan den sparas och berättar för personen om det gick bra. Den här handledningen bygger den formen: en tabell, en kö som bara visar det som fortfarande behöver uppmärksamhet, ett formulär som vägrar spara tills det är rimligt ifyllt och två olika varningar beroende på vad som hände. Räkna med ungefär 25 minuter.
Det här bygger du
- En tabell Ordrar med kund, produkt, antal och status.
- En komponent Order Queue (Multivy) vars datakälla är filtrerad till bara väntande ordrar.
- En komponent Order Intake (Enkelvy) med ett formulär.
- Ett sparflöde som kontrollerar att formuläret är ifyllt innan något skrivs, en felvarning när det inte är det och en lyckad varning när det är det.
Den här handledningen utgår från formen i Bygg ett litet CRM: en tabell, en Multivy-lista, ett Enkelvy-formulär och ett sparflöde. Den lägger mindre tid på de grunderna och mer på det som är nytt här: en filtrerad datakälla och ett arbetsflöde som grenar sig.
Steg 1: Skapa tabellen Ordrar
Lägg till tabellen
Högerklicka på Databas i trädet till vänster, välj Skapa, ställ in Typ på Tabell, välj en
DBS-drivrutin och ge den namnet ORD - Orders.
Lägg till fälten
På fliken Fält använder du Lägg till fält för: ORD_Order_Id (String, obligatoriskt), ORD_Customer_Name
(String, obligatoriskt), ORD_Product (String, obligatoriskt), ORD_Quantity (Number, obligatoriskt),
ORD_Status (String).
Lägg till ett unikt index
På fliken Index lägger du till ett index på ORD_Order_Id och slår på Unik.
Lägg till exempelrader
På fliken Data lägger du till två eller tre ordrar för hand med olika ORD_Status-värden, så att
nästa steg har något att filtrera.
Steg 2: Bygg Order Queue med en filtrerad datakälla
Lägg till komponenten
Högerklicka på Program, Skapa, Typ Komponent, Utdata Multivy, ge den namnet
Order Queue.
Anslut datakällan med en fråga
Öppna fliken Datakälla, välj DB-tabell, välj ORD - Orders och ställ in filterläget på
Fråga i stället för Index. Använd vyn Byggaren för att lägga till en regel: ORD_Status är lika med Pending.
Till skillnad från CRM-handledningens Contacts List, som laddade varje rad via ett index, får den här komponenten
bara de rader som matchar regeln. Se Komponentens datakälla.
Ta in fälten och lägg ut en rad
På fliken Fält tar du in ORD_Customer_Name, ORD_Product, ORD_Quantity och
ORD_Status som Tabell-fält. På fliken UI lägger du till ett radelement, markerar det och slår på
For-loop i Elementegenskaper så att det upprepas en gång per order som fortfarande väntar.
Förhandsgranska
Slå på Live-förhandsgranskning och bekräfta att bara de väntande exempelordrarna visas, inte de du gav en annan status.
Steg 3: Bygg formuläret Order Intake
Lägg till komponenten
Högerklicka på Program, Skapa, Typ Komponent, Utdata Enkelvy, ge den namnet
Order Intake.
Lägg till dess fält
På fliken Fält lägger du till ORD_Customer_Name, ORD_Product och ORD_Quantity som Tabell-
fält med ORD - Orders som källa. Lämna ORD_Status utanför formuläret. Det sätts av arbetsflödet i
nästa steg, inte av personen som lägger ordern.
Bygg inmatningarna
På fliken UI lägger du till en inmatning för vart och ett av de tre fälten, markerar var och en och använder Bind i
Elementegenskaper för att koppla den till sitt fält med xu-bind.
Steg 4: Koppla sparflödet, med validering
Lägg till ett Sätt data-program
Högerklicka på Program, Skapa, Typ Sätt data, ge det namnet Save Order. Låt crudMode
stå på C. I dess Fält-rutnät binder du ORD_Customer_Name, ORD_Product och ORD_Quantity som
Tabell-fält, plus ORD_Status också som ett Tabell-fält. Värdet för det sista kommer
från arbetsflödessteget, inte från formuläret.
Lägg till två Varning-program
Högerklicka på Program, Skapa, Typ Varning två gånger: Order Saved (Typ Success, Visa
Toast, Titel "Order received", Innehåll "The order was saved.") och låt det ogiltiga fallet hanteras av en
infogad varning i själva arbetsflödet, så att det inte behöver något eget program. Se
Varning.
Starta Spara-knappens arbetsflöde
Tillbaka i Order Intake markerar du Spara-knappen, öppnar Arbetsflöden och använder Lägg till åtgärd för att bygga:
Laddningsindikator på (UI-verktyg), en infogad Varning (UI-verktyg) för det ogiltiga fallet, Sätt data
(Databas) som pekar på Save Order med ORD_Status mappad till det fasta värdet Pending, Anropa
varning (UI-verktyg) som pekar på Order Saved, och sedan Laddningsindikator av.
Gör varningen för det ogiltiga fallet villkorad
Högerklicka på det infogade Varning-steget och välj Villkor. Ställ in dess uttryck så att det bara är sant när formuläret är ofullständigt, till exempel ett kundnamn, en produkt eller ett antal som fortfarande är tomt. Fyll i dess Varning-fält direkt: Typ Error, Visa Toast, Titel "Check the order", Innehåll "Fill in customer, product and quantity before saving."
Låt Sätt data-steget få motsatt villkor
Högerklicka på steget Sätt data, välj Villkor och ställ in dess uttryck så att det bara är sant när formuläret är komplett, exakt motsatsen till Varning-stegets villkor. Gör samma sak för steget Anropa varning efter det, så att en sparning bara når den lyckade varningen när Sätt data faktiskt har körts. Se Händelser, arbetsflöde för vad Villkor och Async styr på ett steg.
Använd kryssrutan på ett arbetsflödessteg för att tillfälligt stänga av det. Stäng av stegen för den giltiga vägen medan du kontrollerar att felvarningen utlöses korrekt för ett tomt fält, och slå sedan på dem igen.
Steg 5: Gör den till en sida
Lägg till en Rutt
Högerklicka på Rutter, Skapa, ge den namnet Orders. Lägg till ett menyalternativ med titeln "Queue" som pekar på
Order Queue och ange det som standardmenyalternativ, och sedan ett andra alternativ med titeln "New Order" som pekar
på Order Intake.
Länka registreringen från kön
Markera ett "New order"-element i Order Queue och ge det ett arbetsflöde: Lägg till åtgärd > Navigation >
Anropa sida, som pekar på Order Intake.
Kontrollera det
Slå på Live-förhandsgranskning. Försök först spara formuläret Order Intake tomt, bekräfta att felmeddelandet
visas och att inget skrivs. Fyll sedan i alla tre fälten, spara, bekräfta att den lyckade toasten
visas och att ordern dyker upp i Order Queue med status Pending.