Créer une application de saisie de commandes
Connectez une source de données filtrée, validez un formulaire avant son enregistrement, et affichez la bonne alerte dans les deux cas.
Une application de saisie de commandes reçoit une demande, la vérifie avant de l'enregistrer, et dit à la personne si cela a fonctionné. Ce tutoriel construit cette forme : une table, une file qui n'affiche que ce qui demande encore de l'attention, un formulaire qui refuse d'enregistrer tant que ce n'est pas cohérent, et deux alertes différentes selon ce qui s'est passé. Prévoyez environ 25 minutes.
Ce que vous allez construire
- Une table Orders avec un client, un produit, une quantité et un statut.
- Un composant Order Queue (Vue multiple) dont la source de données est filtrée sur les commandes en attente uniquement.
- Un composant Order Intake (Vue unique) avec un formulaire.
- Un workflow d'enregistrement qui vérifie que le formulaire est rempli avant d'écrire quoi que ce soit, une Alerte d'erreur si ce n'est pas le cas, et une Alerte de succès si c'est le cas.
Ce tutoriel suppose la forme vue dans Créer un petit CRM : une table, une liste en Vue multiple, un formulaire en Vue unique et un workflow d'enregistrement. Il consacre moins de temps à ces bases et plus aux parties nouvelles ici : une source de données filtrée, et un workflow qui se ramifie.
Étape 1 : créer la table Orders
Ajouter la table
Dans l'arborescence de gauche, faites un clic droit sur Base de données, choisissez Créer, réglez Type sur
Tableau, choisissez un Pilote DBS, et nommez-la ORD - Orders.
Ajouter les champs
Dans l'onglet Champs, utilisez Ajouter un champ pour : ORD_Order_Id (String, obligatoire),
ORD_Customer_Name (String, obligatoire), ORD_Product (String, obligatoire), ORD_Quantity (Number, obligatoire),
ORD_Status (String).
Ajouter un index unique
Dans l'onglet Index, ajoutez un index sur ORD_Order_Id et activez Unique.
Ajouter des lignes d'exemple
Dans l'onglet Données, ajoutez à la main deux ou trois commandes avec des valeurs ORD_Status différentes, pour
que l'étape suivante ait quelque chose à filtrer.
Étape 2 : construire Order Queue avec une source de données filtrée
Ajouter le composant
Faites un clic droit sur Programmes, Créer, Type Composant, Sortie Vue multiple, nommez-le
Order Queue.
Connecter la source de données avec une requête
Ouvrez l'onglet Source de données, choisissez Table de la BD, sélectionnez ORD - Orders, et réglez le mode
de filtre sur Requête au lieu d'Index. Utilisez la vue Générateur pour ajouter une règle : ORD_Status égal à
Pending. Contrairement à la liste Contacts List du CRM, qui chargeait chaque ligne par un index, ce composant ne
reçoit que les lignes qui correspondent à la règle. Consultez
Source de données d'un composant.
Importer les champs et mettre en page une ligne
Dans l'onglet Champs, importez ORD_Customer_Name, ORD_Product, ORD_Quantity et ORD_Status comme champs
Tableau. Dans l'onglet Interface, ajoutez un élément de ligne, sélectionnez-le et activez Boucle Pour dans
les propriétés de l'élément pour qu'il se répète une fois par commande encore en attente.
L'aperçu
Activez Aperçu en direct et confirmez que seules les commandes d'exemple en attente apparaissent, pas celles que vous avez marquées avec un autre statut.
Étape 3 : construire le formulaire Order Intake
Ajouter le composant
Faites un clic droit sur Programmes, Créer, Type Composant, Sortie Vue unique, nommez-le
Order Intake.
Ajouter ses champs
Dans l'onglet Champs, ajoutez ORD_Customer_Name, ORD_Product et ORD_Quantity comme champs Tableau
issus de ORD - Orders. Laissez ORD_Status hors du formulaire. Il est défini par le workflow de l'étape suivante,
pas saisi par la personne qui passe la commande.
Construire les champs de saisie
Dans l'onglet Interface, ajoutez un champ de saisie pour chacun des trois champs, sélectionnez-les un par un, et
utilisez Lier dans les propriétés de l'élément pour le relier à son champ avec xu-bind.
Étape 4 : relier le workflow d'enregistrement, avec validation
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 Order. Laissez
crudMode sur C. Dans sa grille Champs, liez ORD_Customer_Name, ORD_Product et ORD_Quantity comme
champs Tableau, plus ORD_Status également comme champ Tableau : la valeur de ce dernier vient de l'étape du
workflow, pas du formulaire.
Ajouter deux programmes Alerte
Faites un clic droit sur Programmes, Créer, Type Alerte, pour Order Saved (Type Succès, Affichage Toast,
Titre « Commande reçue », Corps « La commande a été enregistrée. ») ; laissez le cas invalide à une alerte intégrée
au workflow lui-même, qui n'a donc pas besoin d'un programme distinct. Consultez
Alerte.
Démarrer le workflow du bouton Enregistrer
De retour sur Order Intake, sélectionnez le bouton Enregistrer, ouvrez Workflows, et Ajouter une action pour
construire : Chargeur activé (UI Utils), une Alerte intégrée (UI Utils) pour le cas invalide, Définir des
données (Base de données) pointé vers Save Order avec ORD_Status associé à la valeur fixe Pending,
Appeler une alerte (UI Utils) pointé vers Order Saved, puis Chargeur désactivé.
Rendre conditionnelle l'Alerte du cas invalide
Faites un clic droit sur l'étape Alerte intégrée et choisissez Condition. Réglez son expression pour qu'elle soit vraie seulement quand le formulaire est incomplet, par exemple un nom de client, un produit ou une quantité encore vide. Renseignez ses champs Alerte directement : Type Erreur, Affichage Toast, Titre « Vérifiez la commande », Corps « Renseignez le client, le produit et la quantité avant d'enregistrer. »
Donner à l'étape Définir des données la condition opposée
Faites un clic droit sur l'étape Définir des données, choisissez Condition, et réglez son expression pour qu'elle soit vraie seulement quand le formulaire est complet, exactement l'opposé de la condition de l'étape Alerte. Faites de même pour l'étape Appeler une alerte qui suit, pour qu'un enregistrement n'atteigne l'alerte de succès que si Définir des données s'est réellement exécuté. Consultez Événements, Workflow pour ce que Condition et Asynchrone contrôlent sur une étape.
Utilisez la case à cocher d'une étape de workflow pour la désactiver temporairement. Désactivez les étapes du chemin valide pendant que vous vérifiez que l'Alerte d'erreur se déclenche correctement sur un champ vide, puis réactivez-les.
Étape 5 : en faire une page
Ajouter un Chemin
Faites un clic droit sur Chemins, Créer, nommez-le Orders. Ajoutez un élément de menu intitulé « File »
pointant vers Order Queue et définissez-le comme élément de menu par défaut, puis un deuxième élément intitulé
« Nouvelle commande » pointant vers Order Intake.
Relier la saisie depuis la file
Sélectionnez un élément « Nouvelle commande » dans Order Queue et donnez-lui un workflow : Ajouter une action >
Navigation > Appeler une page, pointé vers Order Intake.
Vérifier
Activez Aperçu en direct. Essayez d'abord d'enregistrer le formulaire Order Intake vide, confirmez que le toast
d'erreur apparaît et que rien n'est écrit. Puis renseignez les trois champs, enregistrez, confirmez que le toast de
succès apparaît et que la commande s'affiche dans Order Queue avec le statut Pending.