Zum Inhalt springen
Geprüft

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.
Lieber beschreiben

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.

Einen blockierenden Alert in der Vorschau vermeiden

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.