Tuto - Créer un projet WEBDEV et son analyse

La leçon précédente nous a permis de créer le projet et l'analyse associée.

• Client,
• Commande,
• ModeRèglement,
• LigneCommande,
• Produit.

• 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 : 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".
   
   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".
   
   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.
   
   
   
   

   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").

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

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

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.
   
   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".
   • Cliquez sur le bouton "+" pour ajouter une nouvelle option dans le sélecteur.
   • L'option 1 correspond à "En attente" : saisissez "En attente" à la place de "Option 1".
   • Cliquez sur le bouton "+" pour ajouter une nouvelle option dans le sélecteur.
   • Saisissez "Validée" à la place de "Option 2".
   • Cliquez sur le bouton "+" pour ajouter une nouvelle option dans le sélecteur.
   • Saisissez "Annulée" à la place de "Option 3".
     
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".

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

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".
   
   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>"
     
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.
   
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.
   
   Conservez les options proposées et passez à l'étape suivante.
9. Terminez l'assistant. WEBDEV crée le fichier de données.

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 (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".
     
     Nous obtenons les données suivantes :
     
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".

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.

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

Nous avons créé toutes les descriptions des fichiers de données nécessaires :

Maintenant nous allons créer les liaisons entre les fichiers de données.

• 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 :
   
   • 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.

     
5. Passez à l'étape suivante. L'assistant propose automatiquement la clé utilisée par la liaison (IDClient).
   
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.
   
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
     
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.
    

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

1. Cliquez sur l'icône (en bas à gauche) pour afficher la 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".

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 :
   
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.
   
7. Validez la description des rubriques (bouton "OK") et celle du fichier de données.

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

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

1. Validez les différentes étapes de l'assistant jusqu'à l'étape listant les fichiers de données à prendre en compte :
   
   • 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.

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.

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