Créer un petit CRM
Modélisez des contacts, listez-les et modifiez-les, puis enregistrez les changements via un workflow, le tout dans un seul projet Studio.
Un CRM a besoin de trois choses : un endroit où garder les contacts, un écran pour les voir, et un moyen d'en ajouter et d'en modifier un. Ce guide parcourt les trois dans Studio, d'un projet vide à une liste de Contacts fonctionnelle avec un workflow d'enregistrement. Prévoyez environ 25 minutes.
Ce que vous allez construire
- Une table Contacts avec un nom, un e-mail, un téléphone et une entreprise.
- Un composant Contacts List (Vue multiple) qui lit la table.
- Un composant Contact Form (Vue unique) qui crée un contact.
- Un programme Définir des données et un programme Alerte derrière le bouton Enregistrer du formulaire.
- Un Chemin qui rend la liste ouvrable comme une page.
Tout ce qui suit peut aussi être saisi sous forme d'invite : « Un CRM avec une table de contacts et un écran qui les liste » vous donne une première version à ajuster. Consultez Démarrer un projet. Ce tutoriel construit la même forme à la main, onglet par onglet.
Étape 1 : créer la table Contacts
Ajouter la table
Dans l'arborescence de gauche, faites un clic droit sur Base de données et choisissez Créer. Réglez Type
sur Tableau, choisissez un Pilote DBS (un projet brouillon utilise automatiquement sa propre base de données
intégrée), et nommez-la CNT - Contacts.
Ajouter les champs
Ouvrez l'onglet Champs de la table et utilisez Ajouter un champ pour chaque colonne : CNT_Contact_Id
(String, obligatoire), CNT_Name (String, obligatoire), CNT_Email (String), CNT_Phone (String), CNT_Company
(String). Le préfixe CNT_ garde ces colonnes sans ambiguïté dès que d'autres tables partagent le projet.
Ajouter un index unique
Dans l'onglet Index, ajoutez un index sur CNT_Contact_Id et activez Unique. Le Contact Form en a besoin
pour retrouver plus tard une ligne précise.
Ajouter une ligne d'exemple
Passez à l'onglet Données et ajoutez un contact avec de vraies valeurs, pour que la liste ait quelque chose à afficher une fois connectée.
Étape 2 : construire la liste Contacts List
Ajouter le composant
Faites un clic droit sur Programmes et choisissez Créer. Réglez Type sur Composant, Sortie sur
Vue multiple, et nommez-le Contacts List.
Connecter la source de données
Ouvrez l'onglet Source de données, choisissez Table de la BD, sélectionnez CNT - Contacts, et réglez le
mode de filtre sur Index pour que l'écran charge chaque contact.
Importer les champs
Ouvrez l'onglet Champs. Une fois la table connectée, Studio propose CNT_Name, CNT_Email, CNT_Phone et
CNT_Company directement à partir de la table : commencez par ces champs Tableau au lieu de recréer les colonnes
à la main.
Mettre en page la ligne
Ouvrez l'onglet Interface. Utilisez l'outil Éléments d'interface ou Étiquette de la barre Insérer pour ajouter une carte ou une ligne, puis sélectionnez-la et activez Boucle Pour dans les propriétés de l'élément pour qu'elle se répète une fois par contact. Liez-y le nom, l'e-mail et le téléphone aux champs correspondants.
L'aperçu
Utilisez le bouton de lecture de la barre d'aperçu de l'interface pour activer Aperçu en direct, puis confirmez que le contact d'exemple apparaît. Consultez Aperçu en direct et console.
Étape 3 : construire le formulaire Contact Form
Ajouter le composant
Faites un clic droit sur Programmes, Créer, Type Composant, Sortie Vue unique, nommez-le
Contact Form.
Ajouter ses champs
Dans l'onglet Champs, ajoutez CNT_Name, CNT_Email, CNT_Phone et CNT_Company comme champs Tableau
issus de CNT - Contacts.
Construire les champs de saisie
Dans l'onglet Interface, ajoutez un champ de saisie pour chaque champ, puis sélectionnez-les un par un pour
ouvrir les propriétés de l'élément. Utilisez Lier pour relier le champ de saisie à son champ avec xu-bind, afin
que la saisie mette à jour le champ.
Étape 4 : relier le workflow d'enregistrement
Ajouter un programme Définir des données
Faites un clic droit sur Programmes, Créer, Type Définir des données, nommez-le Save Contact. Laissez
crudMode sur C pour créer une nouvelle ligne. Dans sa grille Champs, liez CNT_Name, CNT_Email,
CNT_Phone et CNT_Company comme champs Tableau, de la même façon que sur la table elle-même.
Ajouter un programme Alerte
Faites un clic droit sur Programmes, Créer, Type Alerte, nommez-le Contact Saved. Dans son onglet
Alerte, réglez Type sur Succès, Affichage sur Toast, Titre sur « Enregistré », Corps sur
« Contact enregistré. »
Relier le bouton Enregistrer
De retour sur le Contact Form, sélectionnez le bouton Enregistrer dans l'onglet Interface et ouvrez Workflows
dans les propriétés de l'élément. Utilisez Ajouter une action pour construire : Chargeur activé (UI Utils),
Définir des données (Base de données) pointé vers Save Contact avec chaque paramètre associé au champ de
formulaire correspondant, Appeler une alerte (UI Utils) pointé vers Contact Saved, puis Chargeur
désactivé. C'est la même forme que le modèle d'enregistrement du catalogue de workflows : Chargeur activé,
Définir des données, Alerte, Chargeur désactivé.
Un affichage en toast est sans risque dans l'Aperçu en direct. Un affichage modal ou browser peut apparaître sous
la forme d'un alert() natif bloquant dans une session d'aperçu. Consultez Alerte.
Étape 5 : en faire une page
Ajouter un Chemin
Faites un clic droit sur Chemins, Créer, nommez-le CRM. Dans l'éditeur de chemins, ajoutez un élément de
menu intitulé « Contacts » qui pointe vers le composant Contacts List, et définissez-le comme élément de menu par
défaut.
Ouvrir le formulaire depuis la liste
Sélectionnez un élément « Ajouter un contact » dans Contacts List et donnez-lui un workflow : Ajouter une action >
Navigation > Appeler une modale, pointé vers Contact Form.
Vérifier
Activez Aperçu en direct, attachez la console à la session en cours, ajoutez un contact via le formulaire, et confirmez qu'il apparaît dans la liste sans actualisation manuelle. Consultez Aperçu en direct et console.