Vai al contenuto
Verificata

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.
Preferisci descriverlo a parole

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.

Evita un avviso bloccante nell'anteprima

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.