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.
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.
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.
Die Erfassung aus der Warteschlange verlinken
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.