Przejdź do treści
Zweryfikowano

Zbuduj małe CRM

Zamodeluj kontakty, wyświetl je i edytuj, a zmiany zapisuj przez przepływ pracy, wszystko w jednym projekcie Studio.

CRM potrzebuje trzech rzeczy: miejsca na kontakty, ekranu do ich oglądania i sposobu na dodanie i edycję kontaktu. Ten samouczek przeprowadza przez wszystkie trzy w Studio, od pustego projektu do działającej listy Kontaktów z przepływem zapisu. Zaplanuj około 25 minut.

Co zbudujesz

  • Tabelę Contacts z imieniem i nazwiskiem, e-mailem, telefonem i firmą.
  • Komponent Contacts List (Multi View), który czyta tę tabelę.
  • Komponent Contact Form (Single View), który tworzy kontakt.
  • Program Set Data i program Alert za przyciskiem Zapisz formularza.
  • Trasę, dzięki której listę można otworzyć jako stronę.
Wolisz to opisać

Wszystko poniżej możesz też wpisać jako prompt: "CRM z tabelą kontaktów i ekranem, który je wyświetla" daje pierwszą wersję do poprawiania. Zobacz Start projektu. Ten samouczek buduje ten sam kształt ręcznie, zakładka po zakładce.

Krok 1: Utwórz tabelę Contacts

Dodaj tabelę

W lewym drzewie kliknij prawym przyciskiem Database i wybierz Utwórz. Ustaw Wpisz na Tabela, wybierz Sterownik DBS (projekt roboczy automatycznie używa własnej wbudowanej bazy danych) i nazwij tabelę CNT - Contacts.

Dodaj pola

Otwórz zakładkę Pola tabeli i użyj Dodaj pole dla każdej kolumny: CNT_Contact_Id (String, obowiązkowe), CNT_Name (String, obowiązkowe), CNT_Email (String), CNT_Phone (String), CNT_Company (String). Prefiks CNT_ utrzymuje jednoznaczność tych kolumn, gdy w projekcie pojawią się inne tabele.

Dodaj unikalny indeks

Na zakładce Indeksy dodaj indeks na CNT_Contact_Id i włącz Unikalne. Contact Form potrzebuje go później, aby znaleźć jeden konkretny wiersz.

Dodaj przykładowy wiersz

Przejdź na zakładkę Dane i dodaj jeden kontakt z prawdziwymi wartościami, żeby lista miała co pokazać po połączeniu.

Krok 2: Zbuduj Contacts List

Dodaj komponent

Kliknij prawym przyciskiem Programy i wybierz Utwórz. Ustaw Wpisz na Komponent, Wyjście na Widok wielokrotny i nazwij go Contacts List.

Połącz źródło danych

Otwórz zakładkę Źródło danych, wybierz Tabela bazy danych, wskaż CNT - Contacts i ustaw tryb filtra na Indeks, aby ekran wczytywał wszystkie kontakty.

Przenieś pola

Otwórz zakładkę Pola. Gdy tabela jest połączona, Studio podpowiada CNT_Name, CNT_Email, CNT_Phone i CNT_Company prosto z tabeli. Zacznij od tych pól typu Tabela zamiast odtwarzać kolumny ręcznie.

Ułóż wiersz

Otwórz zakładkę UI. Użyj narzędzia Elementy UI lub Znacznik z paska Wstaw, aby dodać kartę lub wiersz, potem zaznacz go i włącz Pętla for we właściwościach elementu, aby powtarzał się raz na kontakt. Powiąż w nim imię i nazwisko, e-mail i telefon z odpowiednimi polami.

Podejrzyj

Użyj przycisku odtwarzania na pasku podglądu UI, aby włączyć Podgląd na żywo, i sprawdź, czy przykładowy kontakt się pojawia. Zobacz Podgląd na żywo i konsola.

Krok 3: Zbuduj Contact Form

Dodaj komponent

Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Komponent, Wyjście Widok pojedynczy, nazwij go Contact Form.

Dodaj jego pola

Na zakładce Pola dodaj CNT_Name, CNT_Email, CNT_Phone i CNT_Company jako pola typu Tabela ze źródłem CNT - Contacts.

Zbuduj pola wprowadzania

Na zakładce UI dodaj pole wprowadzania dla każdego pola, potem zaznacz każde z nich, aby otworzyć właściwości elementu. Użyj Powiąż, aby połączyć pole wprowadzania z jego polem przez xu-bind, tak by wpisywanie aktualizowało pole.

Krok 4: Podłącz przepływ zapisu

Dodaj program Set Data

Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Set Data, nazwij go Save Contact. Zostaw crudMode na C, aby tworzyć nowy wiersz. W jego siatce Pola powiąż CNT_Name, CNT_Email, CNT_Phone i CNT_Company jako pola typu Tabela, tak samo jak w samej tabeli.

Dodaj program Alert

Kliknij prawym przyciskiem Programy, Utwórz, Wpisz Alert, nazwij go Contact Saved. Na jego zakładce Alert ustaw Wpisz na Success, Wyświetlanie na Toast, Tytuł na "Saved", Treść na "Contact saved."

Podłącz przycisk Zapisz

Wróć do Contact Form, zaznacz przycisk Zapisz na zakładce UI i otwórz Przepływy pracy we właściwościach elementu. Użyj Dodaj akcję, aby zbudować: Włącz wskaźnik ładowania (Narzędzia UI), Ustaw dane (Baza danych) wskazujące Save Contact, z każdym parametrem zmapowanym na odpowiednie pole formularza, Wywołaj alert (Narzędzia UI) wskazujący Contact Saved, a na końcu Wyłącz wskaźnik ładowania. To ten sam kształt co wzorzec zapisu z katalogu przepływów: Loader On, Set Data, Alert, Loader Off.

Unikaj blokującego alertu w podglądzie

Wyświetlanie typu toast jest bezpieczne w Podglądzie na żywo. Wyświetlanie modal lub browser może w sesji podglądu pojawić się jako natywny blokujący alert(). Zobacz Alert.

Krok 5: Zrób z tego stronę

Dodaj trasę

Kliknij prawym przyciskiem Trasy, Utwórz, nazwij ją CRM. W edytorze tras dodaj pozycję menu o tytule "Contacts" wskazującą komponent Contacts List i ustaw ją jako domyślną pozycję menu.

Otwórz formularz z listy

Zaznacz element "Add contact" w Contacts List i nadaj mu przepływ pracy: Dodaj akcję > Navigation > Wywołaj modal, wskazujący Contact Form.

Sprawdź

Włącz Podgląd na żywo, podłącz konsolę do działającej sesji, dodaj kontakt przez formularz i sprawdź, czy pojawia się na liście bez ręcznego odświeżania. Zobacz Podgląd na żywo i konsola.