Gå til indhold
Bekræftet

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.
Fortsætter fra CRM-vejledningen

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.

Test én gren ad gangen

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.

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.