Byg et lille CRM
Modeller kontakter, vis og rediger dem, og gem ændringer gennem en arbejdsgang, alt sammen i ét Studio-projekt.
Et CRM har brug for tre ting: et sted at gemme kontakter, en skærm til at se dem og en måde at tilføje og redigere en på. Her gennemgår du alle tre i Studio, fra et tomt projekt til en fungerende kontaktliste med en gemmearbejdsgang. Afsæt omkring 25 minutter.
Det her bygger du
- En tabel Contacts med navn, e-mail, telefon og virksomhed.
- En komponent Contacts List (Multi View), der læser tabellen.
- En komponent Contact Form (Single View), der opretter en kontakt.
- Et Set Data-program og et Alert-program bag formularens knap Gem.
- En Route, der gør listen åbnelig som en side.
Alt herunder kan også skrives som en prompt: "Et CRM med en tabel til kontakter og en skærm, der viser dem" giver dig en første version at justere ud fra. Se Start et projekt. Denne vejledning bygger den samme form i hånden, én fane ad gangen.
Trin 1: Opret tabellen Contacts
Tilføj tabellen
Højreklik på Database i træet til venstre, og vælg Opret. Sæt Type til Tabel, vælg
en DBS-driver (et kladdeprojekt bruger automatisk sin egen indbyggede database), og navngiv den
CNT - Contacts.
Tilføj felterne
Åbn tabellens fane Felter, og brug Tilføj felt til hver kolonne: CNT_Contact_Id (String,
obligatorisk), CNT_Name (String, obligatorisk), CNT_Email (String), CNT_Phone (String),
CNT_Company (String). Præfikset CNT_ holder kolonnerne entydige, når andre tabeller senere
deler projektet.
Tilføj et unikt indeks
Tilføj et indeks på CNT_Contact_Id på fanen Indekser, og slå Unik til. Contact Form har
brug for det for at finde én bestemt række senere.
Tilføj en eksempelrække
Skift til fanen Data, og tilføj én kontakt med rigtige værdier, så listen har noget at vise, når den er forbundet.
Trin 2: Byg Contacts List
Tilføj komponenten
Højreklik på Programmer, og vælg Opret. Sæt Type til Komponent og Output til
Multi View, og navngiv den Contacts List.
Forbind datakilden
Åbn fanen Datakilde, vælg DB-tabel, vælg CNT - Contacts, og sæt filtertilstanden til
Indeks, så skærmen indlæser alle kontakter.
Hent felterne ind
Åbn fanen Felter. Når tabellen er forbundet, foreslår Studio CNT_Name, CNT_Email,
CNT_Phone og CNT_Company direkte fra tabellen. Start med de Tabel-felter i stedet for at
oprette kolonnerne igen i hånden.
Læg rækken ud
Åbn fanen UI. Brug UI-elementer eller værktøjet Tag i Insert-værktøjslinjen til at tilføje et kort eller en række, markér den, og slå For-løkke til i Elementegenskaber, så den gentages én gang pr. kontakt. Bind navn, e-mail og telefon inde i den til de tilsvarende felter.
Se et eksempel
Brug afspilningsknappen i UI-forhåndsvisningens værktøjslinje til at slå Live-forhåndsvisning til, og kontrollér, at eksempelkontakten dukker op. Se Live-forhåndsvisning og konsol.
Trin 3: Byg Contact Form
Tilføj komponenten
Højreklik på Programmer, Opret, Type Komponent, Output Single View, og navngiv den
Contact Form.
Tilføj dens felter
Tilføj CNT_Name, CNT_Email, CNT_Phone og CNT_Company på fanen Felter som
Tabel-felter fra CNT - Contacts.
Byg inputfelterne
Tilføj et inputfelt for hvert felt på fanen UI, og markér derefter hvert enkelt for at åbne
Elementegenskaber. Brug Bind til at forbinde inputfeltet med dets felt via xu-bind, så
indtastning opdaterer feltet.
Trin 4: Forbind gemmearbejdsgangen
Tilføj et Set Data-program
Højreklik på Programmer, Opret, Type Set Data, og navngiv det Save Contact. Lad
crudMode stå på C for at oprette en ny række. Bind CNT_Name, CNT_Email, CNT_Phone og
CNT_Company som Tabel-felter i dets Felter-gitter, på samme måde som i selve tabellen.
Tilføj et Alert-program
Højreklik på Programmer, Opret, Type Alert, og navngiv det Contact Saved. Sæt
Type til Success, Visning til Toast, Titel til "Saved" og Indhold til "Contact
saved." på dets fane Alert.
Forbind knappen Gem
Tilbage i Contact Form markerer du knappen Gem på fanen UI og åbner Arbejdsgange i
Elementegenskaber. Brug Tilføj handling til at bygge: Loader til (UI-værktøjer), Sæt
data (Database) rettet mod Save Contact, hvor hver parameter er koblet til det tilsvarende
formularfelt, Kald alarm (UI-værktøjer) rettet mod Contact Saved og til sidst Loader fra.
Det er den samme form som arbejdsgangskatalogets eget gemmemønster: Loader til, Set Data, Alert,
Loader fra.
En toast-visning er sikker i Live-forhåndsvisning. En modal- eller browser-visning kan i stedet
komme frem som en indbygget blokerende alert() i en forhåndsvisningssession. Se Alert.
Trin 5: Gør det til en side
Tilføj en Route
Højreklik på Ruter, Opret, og navngiv den CRM. Tilføj et menupunkt med titlen "Contacts"
rettet mod komponenten Contacts List i Route-editoren, og sæt det som standardmenupunkt.
Åbn formularen fra listen
Markér et element "Add contact" på Contacts List, og giv det en arbejdsgang: Tilføj handling >
Navigation > Kald modal, rettet mod Contact Form.
Tjek det
Slå Live-forhåndsvisning til, tilslut konsollen til den kørende session, tilføj en kontakt via formularen, og kontrollér, at den dukker op på listen uden manuel opdatering. Se Live-forhåndsvisning og konsol.