Tuto - Créer un projet WINDEV 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 WINDEV :
  • 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 WINDEV :

1. Sous l'éditeur d'analyses, sous le volet "Analyse" du ruban, dans le groupe "Création", 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. La liste des fichiers de données prédéfinis est affichée.
   
   Nous allons créer le fichier de données "Client". Dans la liste des fichiers de données, sélectionnez "Client". Passez à l'étape suivante.
4. L'assistant propose la liste des rubriques à intégrer dans le fichier de données Client.
   
   
   
   

   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.
5. Cochez uniquement les rubriques suivantes : IDClient, Société, Nom, Prénom, Adresse, CodePostal, Ville, EtatDep, Pays, Téléphone, Mobile, Email.
6. 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 :

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 WINDEV.
   Chaque fois qu'un enregistrement est ajouté dans le fichier de données, WINDEV affecte automatiquement une valeur à l'identifiant du fichier de données. Cette valeur est unique.
5. Passez à l'étape suivante et sélectionnez 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 de la table. Saisissez :
   • le nom : Etat
   • le libellé : Etat
   • 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 fenêtres liées au fichier de données. Vous retrouvez ici le type du champ et le libellé.
   Nous allons saisir les options suivantes dans l'onglet "Contenu" :
   • Cliquez sur l'onglet "Contenu".
   • Cliquez sur le bouton "+" pour ajouter la première option.
   • L'option 1 correspond à En attente. Saisissez "En attente" dans le champ de saisie à droite du sélecteur.
   • Cliquez sur le bouton "+" pour ajouter la seconde option.
   • Saisissez "Validée" à la place de "Option 2".
   • Cliquez à nouveau sur le bouton "+".
   • Saisissez "Annulée" à la place de "Option 3".
     
3. Validez la fenêtre de description du champ relié à la rubrique.

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.

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, WINDEV­ 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 de fichiers se lance.
3. Sélectionnez le format des fichiers à importer. Ici, sélectionnez "Fichier texte".
   
   Passez à l'étape suivante de l'assistant.
4. Indiquez le chemin du fichier à importer : "\Tutorial\WD\Exercises\WD Ma Première Base De Données\ModeRèglement.csv" présent dans le répertoire d'installation de WINDEV.
5. Passez à l'étape suivante de l'assistant.
6. Indiquez les paramètres d'importation suivants :
   • Les enregistrements sont délimités par : "<Retour chariot/Saut de ligne>".
   • Les colonnes sont délimitées par : "<Point-virgule>".
   • Les chaînes sont délimitées par : "<Aucun>".
   • Séparateur décimal : "<Automatique : point ou virgule>"
     
7. N'oubliez pas de cocher l'option "La première ligne contient les noms des colonnes".
8. Passez à l'étape suivante.
9. La structure du fichier de données qui va être créé apparaît.
   
   Conservez les options par défaut. Passez à l'étape suivante de l'assistant.
10. Le contenu du fichier CSV va être automatiquement converti au format HFSQL. L'assistant vous propose de créer le fichier HFSQL dans le répertoire du projet.
    
    Conservez les options proposées et passez à l'étape suivante.
11. Terminez l'assistant. WINDEV crée le fichier de données.

1. Sélectionnez le fichier de données "ModeRèglement".
2. Dans le menu contextuel (clic droit), sélectionnez l'option "Description du fichier de données".
3. Dans la fenêtre qui s'affiche, modifiez le libellé du fichier de données : supprimez "(Importé)".
4. Cliquez sur l'icône (en bas, à gauche) pour afficher la description des rubriques du fichier de données.
5. 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".
     
6. Nous obtenons les données suivantes :
   
7. 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

La dernière méthode que nous allons voir pour créer des fichiers de données est la simple 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 WINDEV suivant : "\Tutorial\WD\Exercises\WD Ma Première Base De Données".
2. Sélectionnez le fichier "Produit.fic".
3. Effectuez un "Drag and Drop" du fichier "Produit.fic" vers l'éditeur d'analyses de WINDEV.
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 "\Tutorial\WD\Exercises\WD Ma Première Base De Données".
3. Copiez via l'explorateur de fichiers, les fichiers "Produit.fic", "Produit.mmo" et "Produit.ndx" présents dans le répertoire "\Tutorial\WD\Exercises\WD Ma Première Base De Données" 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 de fichiers de données nécessaires à l'application de gestion de comptes. Maintenant nous allons créer les liaisons entre les 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 de 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 le fichier de données "Produit" et le fichier de données "Commande". Cette liaison va nous permettre de créer un fichier de liaison, le fichier des lignes de commandes.

1. Créez de la même manière la liaison entre les fichiers de données.
2. Répondez aux questions posées par l'assistant :
   • Chaque Produit a au moins une Commande : Non
   • Chaque Produit peut avoir plusieurs Commandes : Oui
   • Chaque Commande a au moins un Produit : Non
   • Chaque Commande peut avoir plusieurs Produits : 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 la clé unique du fichier de données Produit à utiliser. Sélectionnez "Référence". 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 Commande à utiliser : "IDCommande". 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.
    

• Modifier le nom du fichier de données.
• Modifier le nom de ses rubriques.
• Ajouter des rubriques pour connaître la quantité de produit commandé et le total de la ligne de commande.

1. Sélectionnez le fichier de données "Produit_Commande".
2. Dans le menu contextuel (clic droit), sélectionnez l'option "Description du fichier de données".
3. Dans la fenêtre qui s'affiche, modifiez dans l'onglet "Général" :
   • 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 de la fenêtre de description du fichier) pour afficher la description des rubriques du fichier de données.
   
2. Ce fichier de relation comporte 3 rubriques. Positionnez le bandeau de sélection sur la rubrique "Référence_IDCommande". 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 "Référence_IDCommande" 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 et créez la rubrique "TotalHT".
3. Une fenêtre s'affiche indiquant que la rubrique existe déjà dans l'analyse et proposant de reprendre ses caractéristiques :
   
   Conservez les options sélectionnées par défaut et validez (bouton "OK").
4. Positionnez-vous sur une nouvelle ligne et créez la rubrique "TotalTTC". Là encore, reprenez la description existante.
5. La description des rubriques pour le fichier de données "LigneCommande" est la suivante.
   
6. 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.). Le projet "connaîtra" ainsi tous les fichiers de données, rubriques, liaisons définis dans l'analyse. Il sera ainsi très simple de manipuler ces éléments depuis les différents éditeurs de WINDEV.

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, WINDEV lance automatiquement la procédure de modification des fichiers de données. Cette opération permet de mettre à jour les fichiers de données (fichiers ".fic") en fonction de leur description dans l'analyse.

1. Validez les différentes étapes jusqu'à l'écran listant les fichiers de données à prendre en compte.
   • WINDEV détecte que le fichier de données ModeRèglement nécessite une mise à jour. Conservez ce fichier de données sélectionné.
   • WINDEV détecte que le fichier de données Produit est déphasé. Sélectionnez ce 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.