Aller au contenu
Vérifié

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.
Dans la continuité du tutoriel CRM

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.

Testez une branche à la fois

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.

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.