Přeskočit na obsah
Ověřeno

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.
Navazujete na návod CRM

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.

Testujte jednu větev po druhé

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.

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.