Een kleine CRM bouwen
Modelleer contacten, toon en bewerk ze en sla wijzigingen op via een workflow, allemaal in één Studio-project.
Een CRM heeft drie dingen nodig: een plek om contacten te bewaren, een scherm om ze te zien en een manier om er een toe te voegen en te bewerken. Dit loopt alle drie in Studio door, van een leeg project tot een werkende lijst Contacten met een opslagworkflow. Reken op ongeveer 25 minuten.
Wat je gaat bouwen
- Een tabel Contacts met een naam, e-mailadres, telefoonnummer en bedrijf.
- Een component Contacts List (Multi View) die de tabel leest.
- Een component Contact Form (Single View) die een contact aanmaakt.
- Een Set Data-programma en een Melding-programma achter de knop Opslaan van het formulier.
- Een Route waarmee de lijst als pagina te openen is.
Alles hieronder kun je ook als prompt typen: "Een CRM met een tabel voor contacten en een scherm dat ze toont" geeft je een eerste versie om verder aan te passen. Zie Een project starten. Deze tutorial bouwt dezelfde opzet met de hand, tabblad voor tabblad.
Stap 1: De tabel Contacts aanmaken
De tabel toevoegen
Klik in de boom links met de rechtermuisknop op Database en kies Aanmaken. Zet Typen op
Tabel, kies een DBS-driver (een conceptproject gebruikt automatisch zijn eigen ingebouwde
database) en geef hem de naam CNT - Contacts.
De velden toevoegen
Open het tabblad Velden van de tabel en gebruik Veld toevoegen voor elke kolom:
CNT_Contact_Id (String, verplicht), CNT_Name (String, verplicht), CNT_Email (String),
CNT_Phone (String), CNT_Company (String). Het voorvoegsel CNT_ houdt deze kolommen
ondubbelzinnig zodra andere tabellen het project delen.
Een unieke index toevoegen
Voeg op het tabblad Indexen een index toe op CNT_Contact_Id en zet Uniek aan. Het Contact
Form heeft dit later nodig om één exacte rij te vinden.
Een voorbeeldrij toevoegen
Ga naar het tabblad Gegevens en voeg één contact toe met echte waarden, zodat de lijst iets te tonen heeft zodra hij is gekoppeld.
Stap 2: De Contacts List bouwen
Het component toevoegen
Klik met de rechtermuisknop op Programma's en kies Aanmaken. Zet Typen op Component,
Uitvoer op Multi View en geef het de naam Contacts List.
De Datasource koppelen
Open het tabblad Datasource, kies DB-tabel, selecteer CNT - Contacts en zet de filtermodus
op Index, zodat het scherm elk contact laadt.
De velden binnenhalen
Open het tabblad Velden. Zodra de tabel is gekoppeld, stelt Studio CNT_Name, CNT_Email,
CNT_Phone en CNT_Company rechtstreeks uit de tabel voor. Begin met die Tabel-velden in
plaats van de kolommen met de hand opnieuw aan te maken.
De rij opmaken
Open het tabblad UI. Gebruik de tool UI-elementen of Tag van de Invoegen-werkbalk om een kaart of rij toe te voegen, selecteer die en zet For-loop aan in de elementeigenschappen, zodat hij zich per contact herhaalt. Bind de naam, het e-mailadres en het telefoonnummer erin aan de bijbehorende velden.
Een voorbeeld bekijken
Gebruik de afspeelknop in de UI-voorbeeldwerkbalk om Live preview aan te zetten en controleer dan of het voorbeeldcontact verschijnt. Zie Live voorbeeld en console.
Stap 3: Het Contact Form bouwen
Het component toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Component,
Uitvoer op Single View en geef het de naam Contact Form.
De velden toevoegen
Voeg op het tabblad Velden CNT_Name, CNT_Email, CNT_Phone en CNT_Company toe als
Tabel-velden met CNT - Contacts als bron.
De invoervelden bouwen
Voeg op het tabblad UI voor elk veld een invoerveld toe en selecteer ze daarna één voor één om
de elementeigenschappen te openen. Gebruik Binden om het invoerveld met xu-bind aan zijn veld
te koppelen, zodat typen het veld bijwerkt.
Stap 4: De opslagworkflow aansluiten
Een Set Data-programma toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Set Data en
noem het Save Contact. Laat crudMode op C staan om een nieuwe rij aan te maken. Bind op
het raster Velden CNT_Name, CNT_Email, CNT_Phone en CNT_Company als Tabel-velden,
op dezelfde manier als op de tabel zelf.
Een Melding-programma toevoegen
Klik met de rechtermuisknop op Programma's, kies Aanmaken, zet Typen op Melding en noem
het Contact Saved. Zet op het tabblad Melding Typen op Success, Weergave op Toast,
Titel op "Saved" en Inhoud op "Contact saved."
De knop Opslaan aansluiten
Selecteer terug in het Contact Form de knop Opslaan op het tabblad UI en open Workflows in de
elementeigenschappen. Bouw met Actie toevoegen: Laadindicator aan (UI-hulpprogramma's),
Gegevens instellen (Database) gericht op Save Contact met elke parameter gekoppeld aan het
bijbehorende formulierveld, Melding aanroepen (UI-hulpprogramma's) gericht op Contact Saved en
dan Laadindicator uit. Dit is dezelfde opzet als het eigen opslagpatroon van de workflowcatalogus:
Laadindicator aan, Gegevens instellen, Melding, Laadindicator uit.
Een toast-weergave is veilig in Live preview. Een weergave modal of browser kan in een
previewsessie in plaats daarvan als een blokkerende native alert() verschijnen. Zie Melding.
Stap 5: Er een pagina van maken
Een Route toevoegen
Klik met de rechtermuisknop op Routes, kies Aanmaken en noem hem CRM. Voeg in de
Routes-editor een menu-item met de titel "Contacts" toe dat naar het component Contacts List
verwijst en stel het in als standaardmenu-item.
Het formulier openen vanuit de lijst
Selecteer een element "Contact toevoegen" op de Contacts List en geef het een workflow: Actie
toevoegen > Navigatie > Modal aanroepen, gericht op Contact Form.
Controleer het
Zet Live preview aan, koppel de console aan de draaiende sessie, voeg via het formulier een contact toe en controleer of het zonder handmatig vernieuwen in de lijst verschijnt. Zie Live voorbeeld en console.