Zum Inhalt springen
Geprüft

Eine Bestell-Erfassungs-App bauen

Eine gefilterte Datenquelle verbinden, ein Formular vor dem Speichern validieren und in beiden Fällen den passenden Alert zeigen.

Eine Bestell-Erfassungs-App nimmt eine Anfrage entgegen, prüft sie vor dem Speichern und sagt der Person, ob es geklappt hat. Dieses Tutorial baut genau diese Form: eine Tabelle, eine Warteschlange, die nur zeigt, was noch Aufmerksamkeit braucht, ein Formular, das sich weigert zu speichern, bis es stimmig ist, und zwei verschiedene Alerts je nachdem, was passiert ist. Plane etwa 25 Minuten ein.

Was du baust

  • Eine Tabelle Orders mit Kunde, Produkt, Menge und Status.
  • Eine Komponente Order Queue (Multi View), deren Datenquelle nur auf ausstehende Bestellungen gefiltert ist.
  • Eine Komponente Order Intake (Single View) mit einem Formular.
  • Ein Speicher-Workflow, der prüft, ob das Formular ausgefüllt ist, bevor er etwas schreibt, einen Fehler-Alert, wenn es das nicht ist, und einen Erfolgs-Alert, wenn es das ist.
Weiter vom CRM-Tutorial

Dieses Tutorial setzt die Form aus Ein kleines CRM bauen voraus: eine Tabelle, eine Multi-View-Liste, ein Single-View-Formular und einen Speicher-Workflow. Es verbringt weniger Zeit mit diesen Grundlagen und mehr mit dem, was hier neu ist: eine gefilterte Datenquelle und ein Workflow, der verzweigt.

Schritt 1: Die Tabelle Orders erstellen

Die Tabelle hinzufügen

Klicke im linken Baum mit der rechten Maustaste auf Datenbank, wähle Erstellen, setze Typ auf Tabelle, wähle einen DBS-Treiber und nenne sie ORD - Orders.

Die Felder hinzufügen

Nutze auf dem Tab Felder Feld hinzufügen für: ORD_Order_Id (String, Pflicht), ORD_Customer_Name (String, Pflicht), ORD_Product (String, Pflicht), ORD_Quantity (Zahl, Pflicht), ORD_Status (String).

Einen eindeutigen Index hinzufügen

Füge auf dem Tab Indizes einen Index auf ORD_Order_Id hinzu und schalte Eindeutig ein.

Beispielzeilen hinzufügen

Füge auf dem Tab Daten zwei oder drei Bestellungen von Hand mit unterschiedlichen ORD_Status-Werten hinzu, damit der nächste Schritt etwas zum Filtern hat.

Schritt 2: Die Order Queue mit gefilterter Datenquelle bauen

Die Komponente hinzufügen

Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Komponente, Ausgabe Multi View, nenne sie Order Queue.

Die Datenquelle mit einer Abfrage verbinden

Öffne den Tab Datenquelle, wähle DB-Tabelle, wähle ORD - Orders und setze den Filtermodus auf Abfrage statt Index. Nutze die Ansicht Builder, um eine Regel hinzuzufügen: ORD_Status ist gleich Pending. Anders als die Contacts List des CRM, die jede Zeile über einen Index geladen hat, erhält diese Komponente nur die Zeilen, die zur Regel passen. Siehe Komponenten-Datenquelle.

Die Felder übernehmen und eine Zeile gestalten

Übernimm auf dem Tab Felder ORD_Customer_Name, ORD_Product, ORD_Quantity und ORD_Status als Tabellen-Felder. Füge auf dem Tab UI ein Zeilenelement hinzu, wähle es aus und schalte in den Elementeigenschaften For-Schleife ein, damit es sich einmal pro noch ausstehender Bestellung wiederholt.

Die Vorschau ansehen

Schalte die Live-Vorschau ein und bestätige, dass nur die ausstehenden Beispielbestellungen erscheinen, nicht die, die du mit einem anderen Status markiert hast.

Schritt 3: Das Formular Order Intake bauen

Die Komponente hinzufügen

Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Komponente, Ausgabe Single View, nenne sie Order Intake.

Seine Felder hinzufügen

Füge auf dem Tab Felder ORD_Customer_Name, ORD_Product und ORD_Quantity als Tabellen- Felder mit der Quelle ORD - Orders hinzu. Lass ORD_Status im Formular weg. Es wird vom Workflow im nächsten Schritt gesetzt, nicht von der Person eingetippt, die die Bestellung aufgibt.

Die Eingaben bauen

Füge auf dem Tab UI für jedes der drei Felder eine Eingabe hinzu, wähle jede aus und nutze Binden in den Elementeigenschaften, um sie mit xu-bind an ihr Feld zu binden.

Schritt 4: Den Speicher-Workflow mit Validierung verdrahten

Ein Daten-setzen-Programm hinzufügen

Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Daten setzen, nenne es Save Order. Lass crudMode auf C. Binde im Raster Felder ORD_Customer_Name, ORD_Product und ORD_Quantity als Tabellen-Felder, dazu ORD_Status ebenfalls als Tabellen-Feld. Der Wert für dieses letzte kommt aus dem Workflow-Schritt, nicht aus dem Formular.

Zwei Alert-Programme hinzufügen

Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Warnung, zweimal: Order Saved (Typ Erfolg, Anzeige Toast, Titel "Bestellung erhalten", Inhalt "Die Bestellung wurde gespeichert.") und lass den ungültigen Fall für einen Inline-Alert im Workflow selbst, dafür braucht es kein eigenes Programm. Siehe Alert.

Den Workflow der Schaltfläche Speichern beginnen

Wähle in Order Intake die Schaltfläche Speichern, öffne Workflows und baue mit Aktion hinzufügen: Ladeanzeige ein (UI Utils), einen Inline-Alert (UI Utils) für den ungültigen Fall, Daten setzen (Datenbank) mit Ziel Save Order, wobei ORD_Status dem festen Wert Pending zugeordnet wird, Alert aufrufen (UI Utils) mit Ziel Order Saved, dann Ladeanzeige aus.

Den Alert für den ungültigen Fall bedingt machen

Klicke mit der rechten Maustaste auf den Inline-Schritt Alert und wähle Bedingung. Setze seinen Ausdruck so, dass er nur wahr ist, wenn das Formular unvollständig ist, zum Beispiel ein Kundenname, Produkt oder eine Menge, die noch leer ist. Fülle seine Warnung-Felder inline aus: Typ Fehler, Anzeige Toast, Titel "Bestellung prüfen", Inhalt "Fülle Kunde, Produkt und Menge aus, bevor du speicherst."

Den Schritt Daten setzen mit der gegenteiligen Bedingung versehen

Klicke mit der rechten Maustaste auf den Schritt Daten setzen, wähle Bedingung und setze seinen Ausdruck so, dass er nur wahr ist, wenn das Formular vollständig ist, genau das Gegenteil der Bedingung des Alert-Schritts. Mache dasselbe beim Schritt Alert aufrufen danach, damit ein Speichern den Erfolgs-Alert nur erreicht, wenn Daten setzen tatsächlich gelaufen ist. Siehe Ereignisse, Workflow, was Bedingung und Async bei einem Schritt steuern.

Einen Zweig nach dem anderen testen

Nutze das Kontrollkästchen an einem Workflow-Schritt, um ihn vorübergehend zu deaktivieren. Schalte die Schritte des gültigen Pfads aus, während du prüfst, ob der Fehler-Alert bei einem leeren Feld korrekt auslöst, und schalte sie dann wieder ein.

Schritt 5: Eine Seite daraus machen

Eine Route hinzufügen

Klicke mit der rechten Maustaste auf Routen, Erstellen, nenne sie Orders. Füge einen Menüpunkt mit dem Titel "Warteschlange" hinzu, der auf Order Queue zeigt, und lege ihn als Standard-Menüpunkt fest, dann einen zweiten Punkt mit dem Titel "Neue Bestellung", der auf Order Intake zeigt.

Wähle in der Order Queue ein Element "Neue Bestellung" und gib ihm einen Workflow: Aktion hinzufügen > Navigation > Seite aufrufen, mit Ziel Order Intake.

Prüfen

Schalte die Live-Vorschau ein. Versuche zuerst, das Formular Order Intake leer zu speichern, bestätige, dass der Fehler-Toast erscheint und nichts geschrieben wird. Fülle dann alle drei Felder aus, speichere, bestätige, dass der Erfolgs-Toast erscheint und die Bestellung mit dem Status Pending in der Order Queue auftaucht.