Vytvořte aplikaci pro příjem objednávek
Připojte filtrovaný zdroj dat, ověřte formulář před uložením a v obou případech zobrazte správné upozornění.
Aplikace pro příjem objednávek přijme požadavek, před uložením ho zkontroluje a řekne uživateli, jestli se to povedlo. Tento návod vytváří právě to: tabulku, frontu, která zobrazuje jen to, co ještě vyžaduje pozornost, formulář, který se neuloží, dokud nedává smysl, a dvě různá upozornění podle toho, co se stalo. Počítejte asi s 25 minutami.
Co vytvoříte
- Tabulku Orders se zákazníkem, produktem, množstvím a stavem.
- Komponentu Order Queue (Multi View), jejíž zdroj dat je filtrován jen na čekající objednávky.
- Komponentu Order Intake (Single View) s formulářem.
- Workflow pro uložení, které před zápisem zkontroluje, zda je formulář vyplněn, zobrazí chybové upozornění, když není, a úspěšné upozornění, když je.
Tento návod předpokládá tvar z Vytvořte malé CRM: tabulku, seznam Multi View, formulář Single View a workflow pro uložení. Základům se věnuje méně a více místa dává tomu, co je tu nové: filtrovanému zdroji dat a workflow, které se větví.
Krok 1: Vytvoření tabulky Orders
Přidání tabulky
Ve stromu vlevo klikněte pravým tlačítkem na Database, zvolte Vytvořit, nastavte Type
na Tabulka, vyberte Ovladač DBS a pojmenujte ji ORD - Orders.
Přidání polí
Na kartě Pole přidejte pomocí Přidat pole: ORD_Order_Id (String, povinné),
ORD_Customer_Name (String, povinné), ORD_Product (String, povinné), ORD_Quantity (Number,
povinné), ORD_Status (String).
Přidání jedinečného indexu
Na kartě Indexy přidejte index na ORD_Order_Id a zapněte Jedinečné.
Přidání ukázkových řádků
Na kartě Údaje ručně přidejte dvě nebo tři objednávky s různými hodnotami ORD_Status, aby
další krok měl co filtrovat.
Krok 2: Vytvoření fronty Order Queue s filtrovaným zdrojem dat
Přidání komponenty
Klikněte pravým tlačítkem na Programy, Vytvořit, Type Component, Výstup Vícenásobné
zobrazení, pojmenujte ji Order Queue.
Připojení zdroje dat pomocí Query
Otevřete kartu Zdroj dat, zvolte Tabulka DB, vyberte ORD - Orders a nastavte režim
filtru na Dotaz místo Index. V zobrazení Builder přidejte pravidlo: ORD_Status se rovná
Pending. Na rozdíl od seznamu Contacts List v CRM, který načítal všechny řádky přes index, tato
komponenta dostane jen řádky, které odpovídají pravidlu. Viz Zdroj dat komponenty.
Převzetí polí a rozvržení řádku
Na kartě Pole převezměte ORD_Customer_Name, ORD_Product, ORD_Quantity a ORD_Status
jako pole typu Tabulka. Na kartě UI přidejte prvek řádku, vyberte ho a ve vlastnostech
prvku zapněte Cyklus For, aby se opakoval pro každou dosud čekající objednávku.
Náhled
Zapněte Živý náhled a ověřte, že se zobrazí jen čekající ukázkové objednávky, ne ty, které jste označili jiným stavem.
Krok 3: Vytvoření formuláře Order Intake
Přidání komponenty
Klikněte pravým tlačítkem na Programy, Vytvořit, Type Component, Výstup Single
View, pojmenujte ji Order Intake.
Přidání jejích polí
Na kartě Pole přidejte ORD_Customer_Name, ORD_Product a ORD_Quantity jako pole typu
Tabulka ze zdroje ORD - Orders. Pole ORD_Status nechte mimo formulář. Nastaví ho workflow
v dalším kroku, nezadává ho člověk, který objednávku zadává.
Vytvoření vstupů
Na kartě UI přidejte vstup pro každé ze tří polí, každý vyberte a pomocí Propojit ve
vlastnostech prvku ho spojte s jeho polem přes xu-bind.
Krok 4: Zapojení workflow pro uložení s ověřením
Přidání programu Set Data
Klikněte pravým tlačítkem na Programy, Vytvořit, Type Set Data, pojmenujte ho
Save Order. Ponechte crudMode na C. V jeho mřížce Pole navažte ORD_Customer_Name,
ORD_Product a ORD_Quantity jako pole typu Tabulka a také ORD_Status jako pole typu
Tabulka. Hodnota posledního pochází z kroku workflow, ne z formuláře.
Přidání dvou programů Alert
Klikněte pravým tlačítkem na Programy, Vytvořit, Type Alert dvakrát: Order Saved
(Type Success, Zobrazení Toast, Název „Order received“, Text „The order was saved.“) a neplatný
případ nechte na vloženém upozornění přímo ve workflow, takže nepotřebuje samostatný program. Viz
Alert.
Zahájení workflow tlačítka Uložit
Zpět ve formuláři Order Intake vyberte tlačítko Uložit, otevřete Workflow a pomocí Přidat
akci sestavte: Zapnout indikátor načítání (Nástroje UI), vložený Alert (Nástroje UI) pro
neplatný případ, Nastavit data (Database) ukazující na Save Order, kde je ORD_Status
namapováno na pevnou hodnotu Pending, Volat upozornění (Nástroje UI) ukazující na
Order Saved a nakonec Vypnout indikátor načítání.
Podmíněné upozornění pro neplatný případ
Klikněte pravým tlačítkem na vložený krok Alert a zvolte Podmínka. Nastavte jeho výraz tak, aby platil jen tehdy, když je formulář nekompletní, například když je jméno zákazníka, produkt nebo množství stále prázdné. Pole jeho Alertu vyplňte přímo: Type Error, Zobrazení Toast, Název „Check the order“, Text „Fill in customer, product and quantity before saving.“
Opačná podmínka pro krok Set Data
Klikněte pravým tlačítkem na krok Nastavit data, zvolte Podmínka a nastavte jeho výraz tak, aby platil jen tehdy, když je formulář kompletní, tedy přesný opak podmínky kroku Alert. Totéž udělejte u následujícího kroku Volat upozornění, aby se uložení dostalo k úspěšnému upozornění, jen když Set Data skutečně proběhl. Co na kroku řídí Podmínka a Async, najdete v Události, workflow.
Zaškrtávacím polem u kroku workflow ho můžete dočasně vypnout. Vypněte kroky platné cesty, zatímco kontrolujete, že se při prázdném poli správně spustí chybové upozornění, a pak je zase zapněte.
Krok 5: Z toho stránka
Přidání trasy Route
Klikněte pravým tlačítkem na Trasy, Vytvořit, pojmenujte ji Orders. Přidejte položku
nabídky s názvem „Queue“ ukazující na Order Queue a nastavte ji jako výchozí položku nabídky,
pak druhou položku s názvem „New Order“ ukazující na Order Intake.
Odkaz na příjem z fronty
Vyberte ve frontě Order Queue prvek „Nová objednávka“ a dejte mu workflow: Přidat akci >
Navigation > Volat stránku, ukazující na Order Intake.
Zkontrolujte to
Zapněte Živý náhled. Nejdřív zkuste uložit formulář Order Intake prázdný, ověřte, že se
zobrazí chybový toast a nic se nezapíše. Pak vyplňte všechna tři pole, uložte, ověřte, že se
zobrazí úspěšný toast a že se objednávka objeví ve frontě Order Queue se stavem Pending.