Crea un'app per la raccolta ordini
Collega un'origine dati filtrata, convalida un modulo prima di salvarlo e mostra l'avviso giusto in entrambi i casi.
Un'app per la raccolta ordini riceve una richiesta, la controlla prima che venga salvata e dice alla persona se è andata a buon fine. Questo tutorial costruisce proprio questa struttura: una tabella, una coda che mostra solo ciò che richiede ancora attenzione, un modulo che rifiuta di salvare finché non ha senso, e due avvisi diversi a seconda di ciò che è successo. Calcola circa 25 minuti.
Cosa costruirai
- Una tabella Orders con cliente, prodotto, quantità e stato.
- Un componente Order Queue (Vista multipla) la cui origine dati è filtrata sui soli ordini in attesa.
- Un componente Order Intake (Vista singola) con un modulo.
- Un flusso di salvataggio che controlla che il modulo sia compilato prima di scrivere qualsiasi cosa, un Avviso di errore quando non lo è e un Avviso di successo quando lo è.
Questo tutorial presuppone la struttura di Crea un piccolo CRM: una tabella, un elenco in Vista multipla, un modulo in Vista singola e un flusso di salvataggio. Dedica meno tempo a queste basi e più alle parti nuove: un'origine dati filtrata e un flusso di lavoro che si ramifica.
Passo 1: crea la tabella Orders
Aggiungi la tabella
Nell'albero a sinistra, fai clic con il tasto destro su Database, scegli Crea, imposta
Tipo su Tabella, scegli un Driver DBS e chiamala ORD - Orders.
Aggiungi i campi
Nella scheda Campi, usa Aggiungi campo per: ORD_Order_Id (String, obbligatorio),
ORD_Customer_Name (String, obbligatorio), ORD_Product (String, obbligatorio), ORD_Quantity
(Number, obbligatorio), ORD_Status (String).
Aggiungi un indice univoco
Nella scheda Indici, aggiungi un indice su ORD_Order_Id e attiva Univoco.
Aggiungi righe di esempio
Nella scheda Dati, aggiungi a mano due o tre ordini con valori diversi di ORD_Status, così il
passo successivo ha qualcosa da filtrare.
Passo 2: costruisci la Order Queue con un'origine dati filtrata
Aggiungi il componente
Fai clic con il tasto destro su Programmi, Crea, Tipo Componente, Output Vista
multipla, e chiamalo Order Queue.
Collega l'origine dati con una Query
Apri la scheda Origine dati, scegli Tabella DB, seleziona ORD - Orders e imposta la
modalità di filtro su Query invece di Indice. Usa la vista Builder per aggiungere una
regola: ORD_Status uguale a Pending. A differenza della Contacts List del CRM, che caricava ogni
riga tramite un indice, questo componente riceve solo le righe che corrispondono alla regola. Vedi
Origine dati del componente.
Porta dentro i campi e disponi una riga
Nella scheda Campi, porta dentro ORD_Customer_Name, ORD_Product, ORD_Quantity e
ORD_Status come campi Tabella. Nella scheda UI, aggiungi un elemento riga, selezionalo e
attiva Ciclo For nelle proprietà dell'elemento, così si ripete una volta per ogni ordine ancora
in attesa.
Vedi l'anteprima
Attiva Anteprima live e verifica che compaiano solo gli ordini di esempio in attesa, non quelli che hai contrassegnato con un altro stato.
Passo 3: costruisci il modulo Order Intake
Aggiungi il componente
Fai clic con il tasto destro su Programmi, Crea, Tipo Componente, Output Vista
singola, e chiamalo Order Intake.
Aggiungi i suoi campi
Nella scheda Campi, aggiungi ORD_Customer_Name, ORD_Product e ORD_Quantity come campi
Tabella con origine ORD - Orders. Lascia ORD_Status fuori dal modulo: viene impostato dal
flusso di lavoro nel passo successivo, non digitato da chi effettua l'ordine.
Costruisci gli input
Nella scheda UI, aggiungi un input per ciascuno dei tre campi, selezionali uno per uno e usa
Associa nelle proprietà dell'elemento per collegarlo al suo campo con xu-bind.
Passo 4: collega il flusso di salvataggio, con la validazione
Aggiungi un programma Imposta dati
Fai clic con il tasto destro su Programmi, Crea, Tipo Imposta dati, e chiamalo
Save Order. Lascia crudMode su C. Nella griglia Campi, associa ORD_Customer_Name,
ORD_Product e ORD_Quantity come campi Tabella, più ORD_Status anch'esso come campo
Tabella: il valore di quest'ultimo viene dal passo del flusso di lavoro, non dal modulo.
Aggiungi due programmi Avviso
Fai clic con il tasto destro su Programmi, Crea, Tipo Avviso, due volte: Order Saved
(Tipo Success, Visualizzazione Toast, Titolo "Order received", Corpo "The order was saved.") e lascia
il caso non valido a un avviso inline nel flusso di lavoro stesso, così non serve un programma
separato. Vedi Avviso.
Inizia il flusso di lavoro del pulsante Save
Torna a Order Intake, seleziona il pulsante Save, apri Flussi di lavoro e usa Aggiungi azione
per costruire: Loader attivato (Utilità UI), un Avviso inline (Utilità UI) per il caso non
valido, Imposta dati (Database) che punta a Save Order con ORD_Status associato al valore
fisso Pending, Chiama avviso (Utilità UI) che punta a Order Saved, poi Loader
disattivato.
Rendi condizionale l'Avviso del caso non valido
Fai clic con il tasto destro sul passo Avviso inline e scegli Condizione. Imposta la sua espressione in modo che sia vera solo quando il modulo è incompleto, per esempio un nome cliente, un prodotto o una quantità ancora vuoti. Compila inline i suoi campi Avviso: Tipo Error, Visualizzazione Toast, Titolo "Check the order", Corpo "Fill in customer, product and quantity before saving."
Imposta la condizione opposta sul passo Imposta dati
Fai clic con il tasto destro sul passo Imposta dati, scegli Condizione e imposta la sua espressione in modo che sia vera solo quando il modulo è completo, l'esatto opposto della condizione del passo Avviso. Fai lo stesso per il passo Chiama avviso che segue, così un salvataggio raggiunge l'avviso di successo solo quando Imposta dati è stato davvero eseguito. Vedi Eventi, flusso di lavoro per cosa controllano Condizione e Async su un passo.
Usa la casella di controllo di un passo del flusso di lavoro per disattivarlo temporaneamente. Disattiva i passi del percorso valido mentre verifichi che l'Avviso di errore scatti correttamente su un campo vuoto, poi riattivali.
Passo 5: trasformalo in una pagina
Aggiungi una Route
Fai clic con il tasto destro su Route, Crea, e chiamala Orders. Aggiungi una voce di menu
intitolata "Queue" che punta a Order Queue e impostala come voce di menu predefinita, poi una
seconda voce intitolata "New Order" che punta a Order Intake.
Collega la raccolta dalla coda
Seleziona un elemento "New order" in Order Queue e dagli un flusso di lavoro: Aggiungi azione >
Navigazione > Chiama pagina, che punta a Order Intake.
Verifica
Attiva Anteprima live. Prova prima a salvare il modulo Order Intake vuoto, verifica che compaia
il toast di errore e che non venga scritto nulla. Poi compila tutti e tre i campi, salva, verifica che
compaia il toast di successo e che l'ordine appaia nella Order Queue con lo stato Pending.