Naar de inhoud springen
Geverifieerd

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.
Liever beschrijven

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.

Vermijd een blokkerende melding in de preview

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.