DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WEBDEV 2024 !
Aide / Tuto WEBDEV / Tuto - Créer un projet WEBDEV et son analyse
  • Leçon 2 - Créer les fichiers dans l'analyse
  • Qu'allons-nous faire ?
  • Création d'un fichier de données
  • Création d'un fichier de données : utilisation d'un fichier de données prédéfini
  • Création d'un fichier de données : création du fichier de données et des rubriques
  • Importation d'un fichier CSV
  • Importation directe de fichiers de données existants
  • Création des liaisons
  • Génération de l'analyse
  • En résumé

Tuto - Créer un projet WEBDEV et son analyse

Leçon 2 - Créer les fichiers dans l'analyse
Ce que vous allez apprendre :
  • Créer une description d'un fichier de données
  • Créer des rubriques
  • Créer des liaisons entre les fichiers.
  • Générer l'analyse.
Durée de la leçon 40 mn
Qu'allons-nous faire ?
La leçon précédente nous a permis de créer le projet et l'analyse associée.
Pour notre exemple, nous allons continuer la création de cette analyse. Elle pourra être utilisée pour une application de gestion de clients et de commandes. Cette analyse comporte cinq fichiers de données (tables) différents :
  • Client,
  • Commande,
  • ModeRèglement,
  • LigneCommande,
  • Produit.
Analyse de cette leçon
Nous allons :
  • Décrire les différents fichiers de données de cette analyse selon différentes méthodes disponibles dans WEBDEV :
    • utiliser un fichier prédéfini.
    • créer entièrement un fichier.
    • importer un fichier CSV.
    • importer un fichier de données HFSQL existant.
  • Générer l'analyse pour pouvoir l'utiliser dans les différents éléments du projet.
Création d'un fichier de données

Création d'un fichier de données : utilisation d'un fichier de données prédéfini

Le premier fichier de données que nous allons créer est le fichier Client. Nous allons pour cela, utiliser un fichier prédéfini proposé par WEBDEV :
  1. Sous l'éditeur d'analyses, sous le volet "Analyse" du ruban, dans le groupe "Analyse", cliquez sur "Nouveau fichier".
    Créer une description de fichier
    L'assistant de création d'un fichier de données se lance.
  2. Dans l'assistant, sélectionnez l'option "Sélectionner une description parmi des fichiers de données prédéfinis".
    Assistant de création d'un fichier de données
    Passez à l'étape suivante de l'assistant.
  3. Dans la liste des fichiers prédéfinis, sélectionnez "Client". Passez à l'étape suivante.
  4. La liste des rubriques à intégrer dans le fichier de données Client s'affiche.
    Assistant de création d'un fichier de données prédéfini

    Cette liste est impressionnante car elle permet de gérer de nombreux types de fichiers de données Client.
    Nous allons conserver uniquement quelques rubriques :
    • Cliquez sur "Aucune" pour désélectionner toutes les rubriques.
    • Cochez uniquement les rubriques suivantes : IDClient, Société, Nom, Prénom, Adresse, CodePostal, Ville, EtatDep, Pays, Téléphone, Mobile, Email.
  5. Terminez l'assistant (bouton "Terminer").
Le fichier de données "Client" est automatiquement créé sous l'éditeur d'analyses.
Fichier de données créé sous l'éditeur d'analyses

Création d'un fichier de données : création du fichier de données et des rubriques

Nous allons maintenant créer le fichier Commande entièrement, sans l'aide d'un assistant :
  1. Sous le volet "Analyse", dans le groupe "Création", cliquez sur "Nouveau fichier". L'assistant de création d'un nouveau fichier de données se lance.
  2. Dans l'assistant, sélectionnez l'option "Créer une nouvelle description d'un fichier de données".
    Assistant de création d'un fichier de données
    Passez à l'étape suivante de l'assistant.
  3. Saisissez le nom du fichier "Commande" dans l'assistant. Ce nom sera utilisé :
    • pour manipuler le fichier de données en programmation. La variable associée au fichier de données sera "Commande".
    • pour construire le nom du fichier de données physique associé (fichier "Commande.fic").
    Automatiquement, le libellé et la description des éléments représentés par les enregistrements du fichier de données apparaissent.
    Pour le champ "Un enregistrement représente", saisissez "Une commande".
    Le champ "Un enregistrement représente" permet d'avoir un libellé clair lors de la description des liaisons entre les fichiers de données. Automatiquement, un libellé est proposé à partir du nom du fichier de données.
    Assistant de création d'un fichier de données - Nom du fichier de données
  4. Dans la zone "Identifiant automatique", conservez l'option "Identifiant automatique sur 8 octets".
    Si un identifiant automatique est défini sur le fichier de données, cela signifie que le fichier de données possède une clé unique, gérée automatiquement par WEBDEV.
    Chaque fois qu'un enregistrement est ajouté dans le fichier de données, WEBDEV affecte automatiquement une valeur à l'identifiant du fichier. Cette valeur est unique.
  5. L'étape suivante de l'assistant vous permet de sélectionner le type de la base associée au fichier de données. Nous allons travailler sur des fichiers de données HFSQL Classic. Cliquez sur le bouton "Terminer" pour valider.
Le fichier de données est automatiquement créé dans l'analyse. La fenêtre de description des rubriques s'ouvre.
Fenêtre de description des rubriques d'un fichier de données
Nous allons saisir les rubriques du fichier de données "Commande". Dans la fenêtre de description des rubriques du fichier de données, vous pouvez déjà voir qu'une rubrique a été automatiquement créée : "IDCommande". Cette rubrique correspond à l'identifiant automatique du fichier de données. Cette rubrique est composée des lettres "ID" et du nom du fichier de données.
Nous allons créer les autres rubriques de ce fichier de données.
Tout d'abord, nous allons créer la rubrique "Date". Cette rubrique contiendra la date de la commande.
  1. Dans la fenêtre de description des rubriques, double-cliquez dans la colonne "Nom" de la première ligne vide. Cette colonne passe automatiquement en saisie. Saisissez "Date".
  2. Cliquez dans la colonne "Libellé". Automatiquement, le nom de la rubrique apparaît. Nous allons modifier le libellé de la rubrique en cliquant dessus : saisissez "Date de la commande". Dans la colonne "Type", le type "Texte" est automatiquement sélectionné. Déroulez la liste et sélectionnez le type "Date".
    Description de la rubrique Date
  3. Cette rubrique va être une clé (un index) de notre fichier de données.
    Les clés permettent d'accélérer les accès aux données et les tris.
    La notion de clé fait partie des caractéristiques d'une rubrique. Une rubrique peut être : non clé, clé unique, clé avec doublons, clé primaire. Pour plus de détails sur ces différents types de clés, consultez Les rubriques clé.
  4. Dans cet exemple, la rubrique "Date" est une clé avec doublons : la valeur de cette clé pourra être présente plusieurs fois dans le fichier de données.
    • Re-sélectionnez la ligne de la rubrique "Date" pour activer les champs de description présents sur la droite de l'écran.
    • Précisez le type de clé utilisé, clé avec doublons.
      Caractéristiques de la clé
  5. Définissez également le sens de parcours de la clé, c'est-à-dire le tri par défaut de cette rubrique. Dans notre cas, lorsqu'un parcours sera effectué sur cette clé, le tri par défaut sera "ascendant".
Nous allons maintenant créer la rubrique "Etat" qui permet de connaître l'état de la commande.
  1. Positionnez-vous sur une nouvelle ligne dans le tableau des rubriques. Saisissez :
    • le nom : Etat
    • le libellé : Etat de la commande
    • le type : Sélecteur, Liste, Combo. Dans la fenêtre qui s'ouvre, vous pouvez sélectionner le type de champ créé par défaut pour cette rubrique. Ici, ce sera un sélecteur. Validez la fenêtre.
  2. Dans la partie basse de l'écran, cliquez sur le lien pour afficher les paramètres du champ lié à la rubrique sélectionnée.
    Lien permettant d'afficher les informations partagées
    Les informations saisies dans la nouvelle fenêtre qui s'affiche seront automatiquement utilisées lors de la création des pages liées au fichier de données. Vous retrouvez ici le type du champ et le libellé.
    Nous allons saisir les différentes options correspondant à l'état de la commande dans l'onglet "Contenu" :
    • Cliquez sur l'onglet "Contenu".
    • L'option 1 correspond à "En attente". Saisissez "En attente" dans le champ de saisie à droite du numéro 1.
    • Saisissez "Validée" dans le champ de saisie à droite du numéro 2.
    • Cliquez sur le bouton "+" pour ajouter une nouvelle option dans le sélecteur.
    • Saisissez "Annulée" à la place de "Option 3".
      Saisie des informations partagées
  3. Validez la fenêtre de paramètres (bouton "OK").
A vous de jouer :
De la même manière :
  • Positionnez-vous sur une nouvelle ligne et créez la rubrique "TotalHT". Cette rubrique est de type "Monétaire".
  • Positionnez-vous sur une nouvelle ligne et créez la rubrique "TotalTTC". Cette rubrique est de type "Monétaire".
Voilà, la description du fichier de données "Commande" est terminée. Validez la fenêtre de description des rubriques.
Le fichier de données "Commande" apparaît sous l'éditeur d'analyses. Pour agrandir le dessin du fichier de données affiché, cliquez sur le fichier de données, sélectionnez la poignée noire en bas du fichier de données et déplacez la souris vers le bas.
Fichiers de données Client et Commande sous l'éditeur d'analyses

Importation d'un fichier CSV

Pour créer le fichier de données "ModeRèglement", contenant les caractéristiques du règlement, nous allons utiliser une autre méthode : l'import d'un fichier CSV.
Un fichier CSV est un fichier texte utilisant un format spécifique. Ce fichier contient des données sur chaque ligne. Ces données sont séparées par un caractère de séparation (généralement une virgule, un point-virgule ou une tabulation).
A partir du fichier CSV contenant les données, WEBDEV­ va créer :
  • la description du fichier de données dans l'analyse,
  • le fichier de données HFSQL avec les données présentes dans le fichier CSV.
Pour importer le fichier CSV dans l'éditeur d'analyse, réalisez les manipulations suivantes :
  1. Dans le ruban, sous le volet "Analyse", dans le groupe "Création", déroulez "Importer" et sélectionnez "Importer des descriptions de fichiers/tables".
  2. L'assistant d'importation d'un fichier se lance.
  3. Sélectionnez le format du fichier de données à importer. Ici, sélectionnez "Fichier texte".
    Analyse - Sélection du type de données à importer
    Passez à l'étape suivante de l'assistant.
  4. Indiquez le chemin du fichier à importer : "\Tutoriel\WB\Exercices\Mon_Site_WEBDEV\ModeRèglement.csv" présent dans le répertoire d'installation de WEBDEV. Passez à l'étape suivante de l'assistant.
  5. Indiquez les paramètres d'importation suivants :
    • Enregistrements délimités par : "<Retour chariot/Saut de ligne>"
    • Colonnes délimitées par : "<Point-virgule>"
    • Chaînes délimitées par : "<Aucun>"
    • Séparateur décimal : "<Automatique : point ou virgule>"
      Paramètres d'importation d'un fichier texte
  6. N'oubliez pas de cocher l'option "La première ligne contient les noms des colonnes". Passez à l'étape suivante.
  7. L'assistant affiche la structure du fichier de données qui va être créé. Conservez les options par défaut. Passez à l'étape suivante.
    Structure du fichier de données importé
  8. Le contenu du fichier CSV va être automatiquement converti au format HFSQL. L'assistant vous propose de créer le fichier de données HFSQL dans le répertoire du projet.
    Conversion des données
    Conservez les options proposées et passez à l'étape suivante.
  9. Terminez l'assistant. WEBDEV crée le fichier de données.
Examinons la description du fichier de données importé :
  1. Sélectionnez le fichier de données "ModeRèglement" puis dans le menu contextuel, sélectionnez l'option "Description du fichier de données".
  2. Dans la fenêtre qui s'affiche, modifiez le libellé du fichier de données : supprimez "(Importé)".
  3. Cliquez sur l'icône Afficher les rubriques du fichier de données (en bas, à gauche) pour afficher la description des rubriques du fichier de données.
  4. Ce fichier de données ne contient pas d'identifiant automatique ni de clé unique. Nous allons passer la rubrique "Code" en clé unique :
    • Positionnez le bandeau de sélection si nécessaire sur la rubrique "Code".
    • Dans la partie droite de l'écran, cliquez sur "Clé unique".
      Caractéristiques des clés
      Nous obtenons les données suivantes :
      Rubriques du fichier CSV importé
  5. Validez la fenêtre de description des rubriques puis la fenêtre de description du fichier de données.

Importation directe de fichiers de données existants

Dernière méthode de création de fichier présentée dans cette leçon, l'importation de fichiers de données HFSQL existants. Nous allons utiliser cette méthode pour créer le fichier de données "Produit".
Les manipulations à effectuer sont les suivantes :
  1. Dans l'explorateur de fichiers de Windows, ouvrez le sous-répertoire de WEBDEV suivant : "\Tutoriel\WB\Exercices\Mon_Site_WEBDEV".
  2. Sélectionnez le fichier "Produit.fic".
  3. Effectuez un "Drag and Drop" du fichier "Produit" vers l'éditeur d'analyses de WEBDEV.
  4. Le fichier de données apparaît sous l'éditeur d'analyses.
Tous les fichiers de données nécessaires sont maintenant présents dans l'éditeur d'analyses.
Avertissement
Nous avons uniquement importé la description du fichier de données "Produit" dans l'analyse de notre projet. Les données contenues dans le fichier de données "Produit" n'ont pas été importées dans le projet.

Pour manipuler les données du fichier que vous venez d'importer :
  1. Ouvrez directement l'explorateur de fichiers sur le répertoire de votre projet : sous le volet "Accueil", dans le groupe "Général", cliquez sur Explorer le répertoire du projet.
  2. Ouvrez un nouvel explorateur de fichiers sur le répertoire "\Tutoriel\WB\Exercices\Mon_Site_WEBDEV".
  3. Copiez via l'explorateur de fichiers, les fichiers "Produit.fic", "Produit.mmo" et "Produit.ndx" présents dans le répertoire "\Tutoriel\WB\Exercices\Mon_Site_WEBDEV" vers le sous-répertoire EXE du répertoire de votre projet.
    Remarque : il y a 3 fichiers à copier :
    • "Produit.fic" : fichier contenant les données,
    • "Produit.mmo" : fichier mémo contenant les images des produits,
    • "Produit.ndx" : fichier contenant les index pour optimiser les recherches dans le fichier de données.
Création des liaisons
Nous avons créé toutes les descriptions des fichiers de données nécessaires :
Fichiers de données présents dans l'analyse de l'exercice
Maintenant nous allons créer les liaisons entre les fichiers de données.
Une liaison permet de définir les contraintes d'intégrité (cardinalités) entre deux fichiers de données.

Nous allons commencer par créer une liaison entre le fichier de données "Client" et le fichier de données "Commande". On peut considérer que :
  • un client peut avoir une ou plusieurs commandes.
  • chaque commande est liée à un client.
Pour créer la liaison :
  1. Sous le volet "Analyse" (présent dans le ruban), dans le groupe "Création", cliquez sur "Nouvelle liaison". Le curseur de la souris se transforme en crayon.
  2. Cliquez sur le fichier de données "Client" puis sur le fichier de données "Commande".
  3. L'assistant de création d'une liaison se lance.
  4. Répondez aux questions posées par l'assistant :
    Assistant de création d'une liaison
    • Chaque Client a au moins une Commande : Non
    • Chaque Client peut avoir plusieurs Commandes : Oui
    • Chaque Commande a au moins un Client : Oui
    • Chaque Commande peut avoir plusieurs Clients : Non
      Si vous connaissez les cardinalités : Vous pouvez également saisir directement les cardinalités de la liaison dans l'assistant.
      Saisie des cardinalités
  5. Passez à l'étape suivante. L'assistant propose automatiquement la clé utilisée par la liaison (IDClient).
    Assistant de création d'une liaison
  6. Affichez l'étape suivante de l'assistant. L'assistant propose de créer la clé "IDClient" dans le fichier de données Commande pour stocker le client correspondant à la commande.
    Assistant de création d'une liaison
  7. Acceptez cette option en passant à l'étape suivante.
  8. Cette étape permet de définir les règles d'intégrité qui seront automatiquement appliquées. Dans notre cas, vous pouvez choisir le comportement que vous souhaitez lors de la suppression d'un client, ainsi que le comportement lors de la modification de l'identifiant du client.
  9. Validez les règles d'intégrité en passant à l'étape suivante de l'assistant.
  10. Cliquez sur le bouton "Terminer". La liaison est automatiquement créée dans l'éditeur d'analyses.
A vous de jouer :
De la même manière, créez une liaison entre les fichiers de données "ModeRèglement" et "Commande". Ces deux fichiers de données sont liés de la façon suivante :
  • Une commande doit avoir un mode de règlement.
  • Un mode de règlement peut être utilisé dans plusieurs commandes. Dans l'assistant :
  • Les cardinalités sont les suivantes : ModeRèglement (0,n), Commande (1,1).
  • La clé de liaison correspond à la rubrique "Code".

Nous allons maintenant créer une liaison entre les fichiers de données "Commande" et "Produit". Cette liaison va nous permettre de créer un fichier de liaison, le fichier de données correspondant aux lignes de commande.
  1. Créez de la même manière la liaison entre les fichiers de données "Commande" et "Produit".
  2. Répondez aux questions posées par l'assistant :
    • Chaque Commande a au moins un Produit : Non
    • Chaque Commande peut avoir plusieurs Produits : Oui
    • Chaque Produit a au moins une Commande : Non
    • Chaque Produit peut avoir plusieurs Commandes : Oui
      Liaison entre les fichiers de données
  3. Passez à l'étape suivante. L'assistant propose de créer un fichier de relation. Conservez l'option "Créer automatiquement le fichier de relation" et passez à l'étape suivante.
  4. L'assistant propose d'utiliser la clé unique du fichier de données Commande : "IDCommande". Passez à l'étape suivante.
  5. Validez la création de la clé en passant à l'étape suivante.
  6. Conservez les options par défaut concernant les règles d'intégrité et passez à l'étape suivante.
  7. L'assistant propose la clé unique du fichier de données Produit à utiliser. Sélectionnez "Référence". Passez à l'étape suivante.
  8. Validez la création de la clé en passant à l'étape suivante.
  9. Conservez les options par défaut concernant les règles d'intégrité et passez à l'étape suivante.
  10. Cliquez sur le bouton "Terminer". Le fichier de relation est automatiquement créé dans l'éditeur d'analyses.
    Analyse avec les liaisons
Nous allons maintenant modifier le fichier de relation qui a été créé par WEBDEV. En effet, ce fichier va contenir les lignes de commande.
Nous allons tout d'abord renommer le fichier de relation. Nous avons déjà réalisé une manipulation similaire lorsque nous avons changé le libellé du fichier de données importé. Mais ici, ce n'est pas juste un libellé qui va être modifié : nous allons également renommer le fichier physique lié à la description du fichier de données.
  1. Sélectionnez le fichier de données "Commande_Produit". Dans le menu contextuel, sélectionnez l'option "Description du fichier de données".
  2. Dans la fenêtre qui s'affiche, modifiez :
    • le nom du fichier de données par "LigneCommande".
    • le nom sur le disque par "LigneCommande".
      Modification du nom du fichier de données
Nous allons maintenant modifier les rubriques de ce fichier de relation.
  1. Cliquez sur l'icône Afficher la description des rubriques (en bas à gauche) pour afficher la description des rubriques du fichier de données.
    Description des rubriques du fichier de données
  2. Ce fichier de données comporte 3 rubriques. Positionnez le bandeau de sélection sur la rubrique "IDCommande_Référence". Cette rubrique est une clé composée.
    Une clé composée est un ensemble de rubriques constituant un index.
    Ce type de clé permet de parcourir le fichier de données sur des critères complexes ou de faire des recherches sur plusieurs rubriques simultanément.
  3. Pour renommer cette rubrique :
    • Cliquez dans la colonne "Nom".
    • Remplacez "IDCommande_Référence" par "IDLigneCommande".
    • Cliquez dans la colonne "Libellé".
    • Remplacez le libellé actuel par "Identifiant de LigneCommande".
Nous allons maintenant ajouter 3 nouvelles rubriques dans ce fichier de relation : Quantité, TotalTTC et TotalHT.
  1. Positionnez-vous sur une nouvelle ligne et créez la rubrique "Quantité". Cette rubrique est de type "Numérique".
  2. Positionnez-vous sur une nouvelle ligne de la table et créez la rubrique "TotalTTC".
  3. Une fenêtre s'affiche, indiquant que la rubrique existe déjà dans l'analyse et proposant de reprendre ses caractéristiques :
    Rubrique existante dans l'analyse
  4. Conservez les options sélectionnées par défaut et validez (bouton "OK").
  5. Positionnez-vous sur une nouvelle ligne de la table et créez la rubrique "TotalHT". Là encore, reprenez la description existante.
  6. La description des rubriques pour le fichier de données "LigneCommande" est la suivante.
    Description des rubriques du fichier de données LigneCommande
  7. Validez la description des rubriques (bouton "OK") et celle du fichier de données.
L'analyse est alors la suivante :
Analyse de l'exercice
Génération de l'analyse
La génération de l'analyse consiste à valider les modifications de l'analyse (création de fichiers de données, ajout ou suppression de rubriques, etc.) et à les propager dans tout le projet (pages, champs reliés, états, etc.).
La génération (synchronisation) de l'analyse est automatiquement proposée à la fermeture de l'éditeur d'analyses si des modifications ont été effectuées.
Il est également possible de générer l'analyse manuellement. C'est ce que nous allons faire.
Pour générer l'analyse :
  1. Dans le ruban de l'éditeur d'analyses, sous le volet "Analyse", dans le groupe "Analyse", cliquez sur "Génération".
  2. La génération de l'analyse est automatiquement lancée.
  3. Comme nous avons modifié les descriptions des fichiers de données présents dans l'analyse, pour mettre à jour les fichiers de données de l'application, WEBDEV propose de lancer la synchronisation de la structure des données déployées (appelée également "procédure de modification des fichiers de données"). Cette opération permet de mettre à jour les fichiers de données physiques (fichiers ".fic") en fonction de leur description dans l'analyse.
  4. Cliquez sur le bouton "Lancer".
L'assistant de modification automatique se lance.
  1. Validez les différentes étapes de l'assistant jusqu'à l'étape listant les fichiers de données à prendre en compte :
    Modification automatique des fichiers de données
    • Le fichier de données ModeRèglement nécessite une mise à jour. Conservez ce fichier sélectionné.
    • Le fichier de données Produit a été copié dans le répertoire du projet. WEBDEV propose de l'associer à cette analyse. Cochez le fichier de données.
  2. Passez à l'étape suivante.
  3. L'assistant propose de réaliser une sauvegarde des fichiers de données existants, ne changez rien et passez à l'étape suivante.
  4. L'assistant propose de saisir des mots de passe de protection des fichiers de données modifiés par la modification automatique. Conservez les options par défaut et passez à l'étape suivante.
  5. La liste des fichiers de données à modifier apparaît. Terminez l'assistant.
La mise à jour des fichiers de données est effectuée.
Fermez l'éditeur d'analyses.
En résumé
Vous venez de découvrir les principales étapes pour la création d'une analyse :
  • Création d'un fichier de données selon plusieurs méthodes.
  • Création des liaisons simples entre les fichiers.
  • Création d'une liaison complexe.
Lorsque votre analyse est décrite et générée, il est possible de :
  • Créer un site complet grâce au RAD (Rapid Application Development).
    Pour plus de détails, consultez Créer une application grâce au RAD.
  • Créer un site complet entièrement personnalisé. Cette méthode sera utilisée pour développer un site complet basé sur une base de données dans la partie 3 de ce tutoriel. Ce site sera basé sur une analyse correspondant à celle que vous avez créée dans cette partie.
Projet corrigé
Vous voulez vérifier le résultat de vos manipulations ? Un projet corrigé est disponible. Ce projet correspond donc au résultat final attendu.
Pour ouvrir le projet corrigé, dans la page d'accueil de WEBDEV, cliquez sur "Tutoriel" puis dans la zone "Tuto - Créer un projet WEBDEV et son analyse (Leçon 1 et 2)", double-cliquez sur "Mon premier site WEBDEV - Corrigé".
Leçon précédenteSommaire
Version minimum requise
  • Version 2024
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/12/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale