Hopp til innholdet
Bekreftet

Bygg en ordreinntaksapp

Koble til en filtrert datakilde, valider et skjema før det lagres, og vis riktig varsel i begge tilfeller.

En ordreinntaksapp tar imot en forespørsel, sjekker den før den lagres og forteller personen om det gikk bra. Denne veiledningen bygger den formen: en tabell, en kø som bare viser det som fortsatt trenger oppmerksomhet, et skjema som nekter å lagre før det gir mening, og to ulike varsler avhengig av hva som skjedde. Sett av omtrent 25 minutter.

Hva du skal bygge

  • En Orders-tabell med kunde, produkt, antall og status.
  • En Order Queue-komponent (Multi View) hvis datakilde er filtrert til bare ventende ordrer.
  • En Order Intake-komponent (Single View) med et skjema.
  • En lagringsarbeidsflyt som sjekker at skjemaet er fylt ut før den skriver noe, et feilvarsel når det ikke er det, og et suksessvarsel når det er det.
Fortsetter fra CRM-veiledningen

Denne veiledningen forutsetter formen fra Bygg et lite CRM: en tabell, en Multi View-liste, et Single View-skjema og en lagringsarbeidsflyt. Den bruker mindre tid på det grunnleggende og mer på det som er nytt her: en filtrert datakilde og en arbeidsflyt som forgrener seg.

Trinn 1: Opprett Orders-tabellen

Legg til tabellen

Høyreklikk Database i treet til venstre, velg Opprett, sett Skriv til Tabell, velg en DBS-driver og gi den navnet ORD - Orders.

Legg til feltene

I Felt-fanen bruker du Legg til felt for: ORD_Order_Id (String, obligatorisk), ORD_Customer_Name (String, obligatorisk), ORD_Product (String, obligatorisk), ORD_Quantity (Number, obligatorisk), ORD_Status (String).

Legg til en unik indeks

Legg til en indeks på ORD_Order_Id i fanen Indekser og slå på Unik.

Legg til eksempelrader

I Data-fanen legger du inn to eller tre ordrer for hånd med ulike ORD_Status-verdier, slik at neste trinn har noe å filtrere.

Trinn 2: Bygg Order Queue med en filtrert datakilde

Legg til komponenten

Høyreklikk Programmer, Opprett, Skriv Komponent, Utdata Multivisning, og gi den navnet Order Queue.

Koble til datakilden med en spørring

Åpne Datakilde-fanen, velg DB-tabell, velg ORD - Orders og sett filtermodusen til Spørring i stedet for Indeks. Bruk Builder-visningen til å legge til en regel: ORD_Status er lik Pending. I motsetning til CRM-ets Contacts List, som lastet alle rader gjennom en indeks, får denne komponenten bare radene som matcher regelen. Se Komponentens datakilde.

Hent inn feltene og legg ut en rad

I Felt-fanen henter du inn ORD_Customer_Name, ORD_Product, ORD_Quantity og ORD_Status som Tabell-felt. I UI-fanen legger du til et radelement, velger det og slår på For-løkke i Element properties, slik at det gjentas én gang per ordre som fortsatt venter.

Forhåndsvis den

Slå på Live forhåndsvisning og bekreft at bare de ventende eksempelordrene vises, ikke de du ga en annen status.

Trinn 3: Bygg Order Intake-skjemaet

Legg til komponenten

Høyreklikk Programmer, Opprett, Skriv Komponent, Utdata Enkeltvisning, og gi den navnet Order Intake.

Legg til feltene

I Felt-fanen legger du til ORD_Customer_Name, ORD_Product og ORD_Quantity som Tabell-felt fra ORD - Orders. La ORD_Status stå utenfor skjemaet. Den settes av arbeidsflyten i neste trinn, ikke skrevet inn av personen som legger inn ordren.

Bygg inndataene

I UI-fanen legger du til et inndatafelt for hvert av de tre feltene, velger hvert av dem og bruker Bind i Element properties til å koble det til feltet med xu-bind.

Trinn 4: Koble opp lagringsarbeidsflyten, med validering

Legg til et Set Data-program

Høyreklikk Programmer, Opprett, Skriv Set Data, og gi det navnet Save Order. La crudMode stå på C. Bind ORD_Customer_Name, ORD_Product og ORD_Quantity som Tabell-felt i Felt-rutenettet, pluss ORD_Status, også som Tabell-felt. Verdien til det siste kommer fra arbeidsflyttrinnet, ikke fra skjemaet.

Legg til to Alert-programmer

Høyreklikk Programmer, Opprett, Skriv Alert to ganger: Order Saved (Skriv Success, Visning Toast, Tittel «Order received», Innhold «The order was saved.») og la det ugyldige tilfellet være et innebygd varsel i selve arbeidsflyten, slik at det ikke trenger et eget program. Se Alert.

Start arbeidsflyten til Save-knappen

Tilbake i Order Intake velger du Save-knappen, åpner Arbeidsflyter og bruker Legg til handling for å bygge: Laster på (UI-verktøy), et innebygd Alert (UI-verktøy) for det ugyldige tilfellet, Set Data (Database) rettet mot Save Order med ORD_Status koblet til den faste verdien Pending, Kall varsel (UI-verktøy) rettet mot Order Saved, og til slutt Laster av.

Gjør Alert for det ugyldige tilfellet betinget

Høyreklikk det innebygde Alert-trinnet og velg Betingelse. Sett uttrykket til sant bare når skjemaet er ufullstendig, for eksempel et kundenavn, produkt eller antall som fortsatt er tomt. Fyll ut Alert-feltene innebygd: Skriv Error, Visning Toast, Tittel «Check the order», Innhold «Fill in customer, product and quantity before saving.»

Gi Set Data-trinnet den motsatte betingelsen

Høyreklikk Set Data-trinnet, velg Betingelse og sett uttrykket til sant bare når skjemaet er komplett, den nøyaktige motsetningen til betingelsen på Alert-trinnet. Gjør det samme for Kall varsel-trinnet etter det, slik at en lagring bare når suksessvarselet når Set Data faktisk har kjørt. Se Hendelser og arbeidsflyt for hva Condition og Async styrer på et trinn.

Test én gren om gangen

Bruk avmerkingsboksen på et arbeidsflyttrinn for å slå det av midlertidig. Slå av trinnene for den gyldige stien mens du sjekker at feil-Alert utløses som den skal på et tomt felt, og slå dem på igjen etterpå.

Trinn 5: Gjør det til en side

Legg til en Route

Høyreklikk Ruter, Opprett, og gi den navnet Orders. Legg til et menyelement med tittelen «Queue» rettet mot Order Queue og sett det som standard menyelement, og deretter et andre element med tittelen «New Order» rettet mot Order Intake.

Velg et «New order»-element i Order Queue og gi det en arbeidsflyt: Legg til handling > Navigation > Kall side, rettet mot Order Intake.

Sjekk det

Slå på Live forhåndsvisning. Prøv først å lagre Order Intake-skjemaet tomt, og bekreft at feiltoasten vises og at ingenting skrives. Fyll deretter ut alle tre feltene, lagre, og bekreft at suksesstoasten vises og at ordren dukker opp i Order Queue med status Pending.