Vai al contenuto
Verificata

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 è.
Se continui dal tutorial sul CRM

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.

Prova un ramo alla volta

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.

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.