Ein kleines CRM bauen
Kontakte modellieren, auflisten und bearbeiten und Änderungen über einen Workflow speichern, alles in einem Studio-Projekt.
Ein CRM braucht drei Dinge: einen Ort für Kontakte, einen Bildschirm, um sie zu sehen, und eine Möglichkeit, einen hinzuzufügen und zu bearbeiten. Hier gehst du alle drei in Studio durch, vom leeren Projekt bis zu einer funktionierenden Kontaktliste mit Speicher-Workflow. Plane etwa 25 Minuten ein.
Was du baust
- Eine Tabelle Contacts mit Name, E-Mail, Telefon und Firma.
- Eine Komponente Contacts List (Multi View), die die Tabelle liest.
- Eine Komponente Contact Form (Single View), die einen Kontakt anlegt.
- Ein Daten-setzen-Programm und ein Alert-Programm hinter der Schaltfläche Speichern des Formulars.
- Eine Route, die die Liste als Seite aufrufbar macht.
Alles unten lässt sich auch als Prompt eingeben: "Ein CRM mit einer Tabelle für Kontakte und einem Bildschirm, der sie auflistet" liefert dir eine erste Version zum Weiterbearbeiten. Siehe Ein Projekt starten. Dieses Tutorial baut dieselbe Form von Hand, Tab für Tab.
Schritt 1: Die Tabelle Contacts erstellen
Die Tabelle hinzufügen
Klicke im linken Baum mit der rechten Maustaste auf Datenbank und wähle Erstellen. Setze Typ auf Tabelle, wähle einen
DBS-Treiber (ein Entwurfsprojekt nutzt automatisch seine eigene eingebaute Datenbank) und nenne sie
CNT - Contacts.
Die Felder hinzufügen
Öffne den Tab Felder der Tabelle und nutze Feld hinzufügen für jede Spalte: CNT_Contact_Id (String,
Pflicht), CNT_Name (String, Pflicht), CNT_Email (String), CNT_Phone (String),
CNT_Company (String). Das Präfix CNT_ hält diese Spalten eindeutig, sobald andere Tabellen sich
das Projekt teilen.
Einen eindeutigen Index hinzufügen
Füge auf dem Tab Indizes einen Index auf CNT_Contact_Id hinzu und schalte Eindeutig ein. Das Contact Form
braucht ihn, um später genau eine Zeile zu finden.
Eine Beispielzeile hinzufügen
Wechsle zum Tab Daten und füge einen Kontakt mit echten Werten hinzu, damit die Liste etwas zu zeigen hat, sobald sie verbunden ist.
Schritt 2: Die Contacts List bauen
Die Komponente hinzufügen
Klicke mit der rechten Maustaste auf Programme und wähle Erstellen. Setze Typ auf Komponente, Ausgabe auf
Multi View und nenne sie Contacts List.
Die Datenquelle verbinden
Öffne den Tab Datenquelle, wähle DB-Tabelle, wähle CNT - Contacts und setze den Filtermodus auf
Index, damit der Bildschirm jeden Kontakt lädt.
Die Felder übernehmen
Öffne den Tab Felder. Ist die Tabelle verbunden, schlägt Studio CNT_Name, CNT_Email,
CNT_Phone und CNT_Company direkt aus der Tabelle vor. Beginne mit diesen Tabellen-Feldern, statt die Spalten
von Hand neu anzulegen.
Die Zeile gestalten
Öffne den Tab UI. Nutze in der Einfügen-Leiste UI-Elemente oder das Werkzeug Tag, um eine Karte oder Zeile hinzuzufügen, wähle sie dann aus und schalte in den Elementeigenschaften For-Schleife ein, damit sie sich einmal pro Kontakt wiederholt. Binde Name, E-Mail und Telefon darin an die passenden Felder.
Die Vorschau ansehen
Nutze die Play-Schaltfläche in der UI-Vorschauleiste, um die Live-Vorschau einzuschalten, und bestätige dann, dass der Beispielkontakt erscheint. Siehe Live-Vorschau und Konsole.
Schritt 3: Das Contact Form bauen
Die Komponente hinzufügen
Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Komponente, Ausgabe Single View, nenne sie
Contact Form.
Seine Felder hinzufügen
Füge auf dem Tab Felder CNT_Name, CNT_Email, CNT_Phone und CNT_Company als Tabellen-
Felder mit der Quelle CNT - Contacts hinzu.
Die Eingaben bauen
Füge auf dem Tab UI für jedes Feld eine Eingabe hinzu und wähle dann jede aus, um die Elementeigenschaften zu öffnen.
Nutze Binden, um die Eingabe mit xu-bind an ihr Feld zu binden, sodass Tippen das Feld aktualisiert.
Schritt 4: Den Speicher-Workflow verdrahten
Ein Daten-setzen-Programm hinzufügen
Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Daten setzen, nenne es Save Contact. Lass crudMode
auf C, um eine neue Zeile anzulegen. Binde im Raster Felder CNT_Name, CNT_Email, CNT_Phone und
CNT_Company als Tabellen-Felder, genauso wie in der Tabelle selbst.
Ein Alert-Programm hinzufügen
Klicke mit der rechten Maustaste auf Programme, Erstellen, Typ Warnung, nenne es Contact Saved. Setze auf seinem Tab WarnungTyp auf Erfolg, Anzeige auf Toast, Titel auf "Gespeichert", Inhalt auf "Kontakt gespeichert."
Die Schaltfläche Speichern verdrahten
Wähle im Contact Form die Schaltfläche Speichern auf dem Tab UI und öffne Workflows in den Elementeigenschaften.
Baue mit Aktion hinzufügen: Ladeanzeige ein (UI Utils), Daten setzen (Datenbank) mit Ziel
Save Contact, wobei jeder Parameter dem passenden Formularfeld zugeordnet wird, Alert aufrufen (UI Utils)
mit Ziel Contact Saved, dann Ladeanzeige aus. Das ist dieselbe Form wie das eigene Speichermuster des Workflow-Katalogs:
Ladeanzeige ein, Daten setzen, Alert, Ladeanzeige aus.
Eine Toast-Anzeige ist in der Live-Vorschau unbedenklich. Eine Anzeige als modal oder browser kann in einer Vorschausitzung stattdessen als nativer
blockierender alert() erscheinen. Siehe Alert.
Schritt 5: Eine Seite daraus machen
Eine Route hinzufügen
Klicke mit der rechten Maustaste auf Routen, Erstellen, nenne sie CRM. Füge im Routen-Editor einen Menüpunkt mit dem Titel
"Kontakte" hinzu, der auf die Komponente Contacts List zeigt, und lege ihn als Standard-Menüpunkt fest.
Das Formular aus der Liste öffnen
Wähle in der Contacts List ein Element "Kontakt hinzufügen" und gib ihm einen Workflow: Aktion hinzufügen >
Navigation > Modal aufrufen, mit Ziel Contact Form.
Prüfen
Schalte die Live-Vorschau ein, verbinde die Konsole mit der laufenden Sitzung, lege über das Formular einen Kontakt an und bestätige, dass er ohne manuelles Neuladen in der Liste erscheint. Siehe Live-Vorschau und Konsole.