Aller au contenu
Vérifié

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.
Préférez la décrire

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é.

Évitez une alerte bloquante dans l'aperçu

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.