Crea un piccolo CRM
Modella i contatti, elencali e modificali, e salva le modifiche con un flusso di lavoro, tutto dentro un unico progetto Studio.
Un CRM ha bisogno di tre cose: un posto dove tenere i contatti, una schermata per vederli e un modo per aggiungerne e modificarne uno. Questa guida le percorre tutte e tre in Studio, da un progetto vuoto a un elenco Contacts funzionante con un flusso di salvataggio. Calcola circa 25 minuti.
Cosa costruirai
- Una tabella Contacts con nome, email, telefono e azienda.
- Un componente Contacts List (Vista multipla) che legge la tabella.
- Un componente Contact Form (Vista singola) che crea un contatto.
- Un programma Imposta dati e un programma Avviso dietro il pulsante Save del modulo.
- Una Route che rende l'elenco apribile come pagina.
Tutto ciò che segue può anche essere scritto come prompt: "A CRM with a table for contacts and a screen that lists them" ti dà una prima versione da rifinire. Vedi Avviare un progetto. Questo tutorial costruisce la stessa struttura a mano, una scheda alla volta.
Passo 1: crea la tabella Contacts
Aggiungi la tabella
Nell'albero a sinistra, fai clic con il tasto destro su Database e scegli Crea. Imposta
Tipo su Tabella, scegli un Driver DBS (un progetto in bozza usa automaticamente il
proprio database integrato) e chiamala CNT - Contacts.
Aggiungi i campi
Apri la scheda Campi della tabella e usa Aggiungi campo per ogni colonna: CNT_Contact_Id
(String, obbligatorio), CNT_Name (String, obbligatorio), CNT_Email (String), CNT_Phone
(String), CNT_Company (String). Il prefisso CNT_ mantiene queste colonne inequivocabili quando
altre tabelle condividono il progetto.
Aggiungi un indice univoco
Nella scheda Indici, aggiungi un indice su CNT_Contact_Id e attiva Univoco. Il Contact
Form ne ha bisogno per individuare in seguito una riga precisa.
Aggiungi una riga di esempio
Passa alla scheda Dati e aggiungi un contatto con valori reali, così l'elenco ha qualcosa da mostrare quando sarà collegato.
Passo 2: costruisci la Contacts List
Aggiungi il componente
Fai clic con il tasto destro su Programmi e scegli Crea. Imposta Tipo su Componente,
Output su Vista multipla e chiamalo Contacts List.
Collega l'origine dati
Apri la scheda Origine dati, scegli Tabella DB, seleziona CNT - Contacts e imposta la
modalità di filtro su Indice, così la schermata carica ogni contatto.
Porta dentro i campi
Apri la scheda Campi. Con la tabella collegata, Studio suggerisce CNT_Name, CNT_Email,
CNT_Phone e CNT_Company direttamente dalla tabella: parti da questi campi Tabella invece di
ricreare le colonne a mano.
Disponi la riga
Apri la scheda UI. Usa lo strumento Elementi UI o Tag della barra Inserisci per aggiungere una card o una riga, poi selezionala e attiva Ciclo For nelle proprietà dell'elemento, così si ripete una volta per contatto. Associa al suo interno nome, email e telefono ai campi corrispondenti.
Vedi l'anteprima
Usa il pulsante play nella barra dell'anteprima UI per attivare Anteprima live, poi verifica che il contatto di esempio compaia. Vedi Anteprima live e console.
Passo 3: costruisci il Contact Form
Aggiungi il componente
Fai clic con il tasto destro su Programmi, Crea, Tipo Componente, Output Vista
singola, e chiamalo Contact Form.
Aggiungi i suoi campi
Nella scheda Campi, aggiungi CNT_Name, CNT_Email, CNT_Phone e CNT_Company come campi
Tabella con origine CNT - Contacts.
Costruisci gli input
Nella scheda UI, aggiungi un input per ogni campo, poi selezionali uno per uno per aprire le
proprietà dell'elemento. Usa Associa per collegare l'input al suo campo con xu-bind, così
digitare aggiorna il campo.
Passo 4: collega il flusso di salvataggio
Aggiungi un programma Imposta dati
Fai clic con il tasto destro su Programmi, Crea, Tipo Imposta dati, e chiamalo
Save Contact. Lascia crudMode su C per creare una nuova riga. Nella griglia Campi,
associa CNT_Name, CNT_Email, CNT_Phone e CNT_Company come campi Tabella, come nella
tabella stessa.
Aggiungi un programma Avviso
Fai clic con il tasto destro su Programmi, Crea, Tipo Avviso, e chiamalo Contact Saved.
Nella sua scheda Avviso imposta Tipo su Success, Visualizzazione su Toast, Titolo su
"Saved" e Corpo su "Contact saved."
Collega il pulsante Save
Torna al Contact Form, seleziona il pulsante Save nella scheda UI e apri Flussi di lavoro nelle
proprietà dell'elemento. Usa Aggiungi azione per costruire: Loader attivato (Utilità UI),
Imposta dati (Database) che punta a Save Contact con ogni parametro associato al campo del
modulo corrispondente, Chiama avviso (Utilità UI) che punta a Contact Saved, poi Loader
disattivato. È la stessa struttura dello schema di salvataggio del catalogo dei flussi di lavoro:
Loader attivato, Imposta dati, Avviso, Loader disattivato.
Una visualizzazione toast è sicura nell'Anteprima live. Una visualizzazione modal o browser può
invece comparire come un alert() nativo bloccante dentro una sessione di anteprima. Vedi
Avviso.
Passo 5: trasformalo in una pagina
Aggiungi una Route
Fai clic con il tasto destro su Route, Crea, e chiamala CRM. Nell'editor delle Route,
aggiungi una voce di menu intitolata "Contacts" che punta al componente Contacts List e
impostala come voce di menu predefinita.
Apri il modulo dall'elenco
Seleziona un elemento "Add contact" nella Contacts List e dagli un flusso di lavoro: Aggiungi
azione > Navigazione > Chiama modale, che punta a Contact Form.
Verifica
Attiva Anteprima live, collega la console alla sessione in esecuzione, aggiungi un contatto tramite il modulo e verifica che compaia nell'elenco senza aggiornamento manuale. Vedi Anteprima live e console.