Lorsqu'un projet utilise des fichiers de données, ce projet doit être associé à une analyse. Une analyse permet de décrire les structures de données (fichiers de données, rubriques, etc.) utilisées dans votre projet.

• 1ère méthode : Création directe de l'analyse (c'est-à-dire création du Modèle Logique des Données (MLD)).
• 2ème méthode : Création du Modèle Conceptuel des Données (MCD), puis création automatique de l'analyse à partir du MCD. Pour plus de détails, consultez Génération du MCD en MLD.

Dans WEBDEV, les termes "MLD" et "Analyse" sont utilisés indifféremment pour définir la structure de la base de données associée à un projet.

Créer une analyse (ou MLD)

Pour créer une analyse (MLD) :

1. Cliquez sur parmi les boutons d'accès rapide. La fenêtre de création d'un nouvel élément s'affiche : cliquez sur "Données" puis sur "Analyse". L'assistant de création d'une analyse se lance.
2. Spécifiez les informations générales concernant l'analyse :
   • le nom et le répertoire de l'analyse. L'analyse correspond à un fichier ".WDA". Par défaut, ce fichier sera créé dans le répertoire de l'analyse du projet (répertoire <Nom du projet>.ANA). Ce répertoire doit être accessible en lecture et en écriture.
   • la description de l'analyse décrivant succinctement le sujet de l'analyse.
3. Dans l'étape suivante, indiquez le type de la base de données :
   • Base de données HFSQLDrive (solution payante, clé en main, utilisant un serveur mutualisé).
   • Base de données HFSQL dans PCSCloud (solution payante, clé en main, proposant un serveur dédié).
   • Base de données HFSQL (Client/serveur ou Classic).
   • Base de données accessible via un Connecteur Natif.
   • Autres types.
4. Dans l'étape suivante, spécifiez si nécessaire les informations de connexion.
5. Terminez l'assistant de création de l'analyse. La création du premier fichier de données est automatiquement proposée.
6. Créez l'ensemble des éléments (fichiers de données, rubriques et liaisons) de votre analyse.

Ajouter un fichier de données dans une analyse

L'analyse permet de décrire la structure des fichiers de données utilisés par le projet. Un fichier de données présent dans l'analyse peut être :

• Un nouveau fichier de données.
• Un fichier de données prédéfini, livré avec WINDEV, WEBDEV ou WINDEV Mobile.
• Un fichier de données importé depuis une base existante (utilisant par exemple un format spécifique).

1. Sous le volet "Analyse", dans le groupe "Création", cliquez sur "Nouveau fichier". L'assistant de création d'un fichier de données se lance.
2. Sélectionnez l'option "Créer une nouvelle description d'un fichier de données".
3. Spécifiez :
   • le nom du fichier de données. Ce nom est le nom logique du fichier de données. Il sera utilisé pour manipuler le fichier de données.
   • le libellé du fichier de données résumant succinctement le sujet du fichier de données.
   • la représentation d'un enregistrement dans le fichier de données. Cette représentation permet d'améliorer la lisibilité des questions posées lors de la description des liaisons. Cette option doit être précédée d'un article indéfini (UN ou UNE).
   • si le fichier de données possède une rubrique de type "Identifiant automatique". La valeur de cette rubrique est unique pour chaque enregistrement et est automatiquement calculée par WINDEV, WEBDEV ou WINDEV Mobile.
   • le type de la base de données associée au fichier de données :
     • Base de données HFSQLDrive (solution payante, clé en main, utilisant un serveur mutualisé).
     • Base de données HFSQL dans PCSCloud (solution payante, clé en main, proposant un serveur dédié).
     • Base de données HFSQL (Client/serveur ou Classic).
     • Base de données accessible via un Connecteur Natif.
     • Autres types.
     Selon le type choisi, ce fichier de données sera manipulé par le moteur HFSQL, par un pilote OLE DB ou par un des Connecteurs Natifs de WINDEV ou WEBDEV (SQL Server, Oracle, ...).
4. Le fichier de données créé devient le fichier de données en cours. La fenêtre de description des rubriques du fichier de données s'ouvre automatiquement. Vous pouvez décrire les rubriques du fichier de données.

1. Sous le volet "Analyse", dans le groupe "Création", cliquez sur "Nouveau fichier". L'assistant de création d'un fichier de données se lance.
2. Sélectionnez l'option "Sélectionner une description parmi des fichiers de données prédéfinis".
3. Choisissez le fichier de données prédéfini à créer (il est possible d'en sélectionner plusieurs). Ce fichier de données sera importé dans l'analyse en cours. Ce fichier de données pourra être modifié par la suite.
4. Sélectionnez les rubriques à conserver. Ces rubriques pourront être modifiées par la suite.
5. Le fichier de données importé est automatiquement inséré dans l'analyse en cours.

1. Sélectionnez le fichier de données.
2. Dans le menu contextuel, sélectionnez l'option "Description du fichier de données" ou l'option "Description des rubriques".

1. Sous le volet "Analyse", dans le groupe "Création", cliquez sur "Nouveau fichier". L'assistant de création d'un fichier de données se lance.
2. Sélectionnez l'option "Utiliser des fichiers de données d'une base existante", puis sélectionnez le type de la base de données.
3. Spécifiez la base de données source contenant les descriptions à importer et le type de cette base de données source. Selon le type choisi, renseignez les informations demandées.
4. Sélectionnez les tables ou les fichiers de données dont la description doit être importée et validez.
5. Le fichier de données importé est automatiquement inséré dans l'analyse en cours.

Créer une rubrique

Pour créer une rubrique :

1. Double-cliquez sur le fichier de données dans lequel la rubrique doit être créée. La fenêtre de description des rubriques du fichier de données s'ouvre.
2. Cliquez sur la première ligne vide du tableau des rubriques.
3. Spécifiez le nom, le libellé et le type de la rubrique directement dans le tableau.
4. Indiquez dans la partie droite de la fenêtre les détails concernant la nouvelle rubrique (type, taille, valeur par défaut, sens de parcours, ...).
5. Indiquez les détails concernant les informations partagées : cliquez sur le lien "Paramètres du champ relié à la rubrique sélectionnée (Informations partagées)".
6. Validez la description de la rubrique.

Créer une liaison

Il est possible de créer différents types de liaison entre les fichiers de données. Pour plus de détails sur les liaisons, consultez le paragraphe Caractéristiques des liaisons définies dans une analyse.

1. Sous le volet "Analyse", dans le groupe "Création", cliquez sur "Nouvelle liaison". Le curseur de la souris se transforme en crayon.
2. Sélectionnez les deux fichiers de données à relier. La fenêtre de description de liaison s'ouvre automatiquement.
3. Pour définir les cardinalités entre les deux fichiers de données :
   • soit sélectionnez directement les cardinalités parmi celles proposées (0,1 ; 1,1 ; 0,N ; 1,N).
   • soit répondez aux questions posées. Les cardinalités seront mises à jour automatiquement.
4. Pour décrire des cardinalités avancées, cochez l'option "Afficher les cardinalités avancées" et répondez aux questions posées.
5. Saisissez le libellé de la liaison en décrivant succinctement le sujet de la liaison.
6. Spécifiez les clés à relier.
7. Précisez les règles d'intégrité. Ces règles permettent d'assurer la cohérence des données lors de la modification ou lors de la suppression d'une des clés de la relation.
8. Validez. La liaison est automatiquement créée.

Fichier de données propriétaire et fichier de données membre

Dans le cas de liaison entre deux fichiers de données, il existe un fichier de données propriétaire et un fichier de données membre :

• le fichier de données propriétaire est propriétaire de la clé.
• le fichier de données membre est un membre des fichiers de données de l'analyse contenant une copie de la clé.

• le fichier de données propriétaire est Fournisseur,
• le fichier de données membre est Produit.

Les cardinalités

Les cardinalités permettent de dénombrer les liens entre les fichiers de données.

1. Pour chaque enregistrement du fichier de données, à combien d'enregistrements de l'autre fichier de données au minimum cet enregistrement est-il relié ?
   La réponse fournit la première partie de la cardinalité (cardinalité minimale) :
   • si la réponse est "aucun", la cardinalité est du type 0,X.
   • si la réponse est "un seul", la cardinalité est du type 1,X.
2. Pour chaque enregistrement du fichier de données, à combien d'enregistrements de l'autre fichier de données au maximum cet enregistrement est-il relié ?
   La réponse fournit la deuxième partie de la cardinalité (cardinalité maximale) :
   • si la réponse est "un seul", la cardinalité est du type X,1.
   • si la réponse est "plusieurs", la cardinalité est du type X,N.

La réponse à ces deux questions définit la cardinalité qui peut être de type : 0,1 ; 0,N ; 1,1 ; 1,N

• chaque "Club" a au moins un "Personne" : Oui/Non ?
• chaque "Club" peut avoir plusieurs "Personnes" : Oui/Non ?
• chaque "Personne" a au moins un "Club" : Oui/Non ?
• chaque "Personne" peut avoir plusieurs "Clubs" : Oui/Non ?

• Cardinalité 0,1 : Une personne peut être inscrite à un seul club de sport. Cette personne n'est pas obligée d'être inscrite à un club de sport.
• Cardinalité 0,N : Un club peut avoir aucune ou plusieurs personnes inscrites.

Les cardinalités avancées

Il est possible de définir avec plus de précision les cardinalités. On parle alors de cardinalités avancées.

• Cardinalité 0,1 : Une personne peut être inscrite à un seul club de sport. Cette personne n'est pas obligée d'être inscrite à un club de sport.
• Cardinalité 0,10 : Un club peut avoir de 0 à 10 personnes inscrites.

L'intégrité référentielle

L'intégrité référentielle d'une base de données correspond au respect des contraintes impliquées par les liaisons entre les fichiers de données.

• si un enregistrement est supprimé dans le propriétaire, les enregistrements correspondants dans les membres sont également supprimés,
• si un enregistrement est ajouté dans un membre, il existe un enregistrement correspondant dans le propriétaire,
• si un enregistrement est modifié dans un propriétaire, la clé unique n'est pas modifiée, ...

La vérification de l'intégrité référentielle dépend de la nature de la liaison entre les fichiers de données. Pour plus de détails sur le contrôle de l'intégrité référentielle, consultez l'aide en ligne.

Les différents types de liaisons

Les liaisons entre fichiers de données peuvent être de plusieurs types :

• parallèle
• facultative
• de complément
• partagée
• complexe

• création d'un enregistrement.
• suppression d'un enregistrement.
• réindexation avec compactage.

• Chaque enregistrement d'un fichier de données (Catégorie) n'a aucun enregistrement ou un seul enregistrement associé dans un autre fichier de données (Groupe).
• Chaque enregistrement de l'autre fichier de données (Groupe) n'a aucun enregistrement ou un seul enregistrement associé dans le premier fichier de données (Catégorie).
  

Une liaison facultative est réalisée en copiant l'identifiant de chacun des fichiers de données dans l'autre fichier de données.

• Chaque enregistrement d'un fichier de données (Produit) n'a aucun enregistrement ou un seul enregistrement associé dans un autre fichier de données (Détail).
• Chaque enregistrement de l'autre fichier de données (Détail) a nécessairement un enregistrement associé dans le premier fichier de données (Produit).
  

Les liaisons de complément sont assez fréquentes. Elles sont notamment utilisées lorsqu'un enregistrement peut avoir des compléments d'informations optionnels.

• Liaison partagée de cardinalité 0,n - 0,1.
• Liaison partagée de cardinalité 0,n - 1,1.
• Liaison partagée de cardinalité 1,n - 0,1.
• Liaison partagée de cardinalité 1,n - 1,1.

• un propriétaire peut ne pas avoir de membre (un fournisseur n'a pas obligatoirement de produit).
• un membre peut ne pas avoir de propriétaire (un produit n'a pas obligatoirement de fournisseur).

• un propriétaire peut ne pas avoir de membre (un fournisseur peut avoir aucun produit).
• chaque membre a un seul propriétaire (chaque produit a un seul fournisseur).

Remarque : Ce type de liaison est fréquent. WINDEV permet de créer automatiquement les fenêtres permettant de gérer les fichiers de données liés par une liaison de type 0,N - 1,1.

• chaque propriétaire a au moins un membre (un fournisseur a au moins un produit).
• un membre peut ne pas avoir de propriétaire (un produit peut avoir aucun fournisseur).
  

Liaison partagée de cardinalité 1,N - 1,1

• chaque propriétaire a au moins un membre (chaque fournisseur a au moins un produit).
• chaque membre a un seul propriétaire (chaque produit a un seul fournisseur).
  

Liaison complexe

• une clé unique composée des clés de Produit et de Commande.
• le nombre de produits commandés.

Les liaisons entre les fichiers de données sont les suivantes :

WEBDEV permet de réaliser les manipulations suivantes sur une analyse (MLD) :

• Dupliquer / Copier une analyse : La duplication d'une analyse permet de disposer de deux analyses identiques de nom différent.
• Supprimer une analyse.
• Renommer une analyse.
• Associer une analyse à un projet.
• Agrandir ou réduire l'affichage d'une analyse sous l'éditeur.
• Déplacer l'affichage d'une analyse sous l'éditeur.

• Dupliquer / Copier un fichier de données.
• Supprimer un fichier de données.
• Renommer un fichier de données.

• Dupliquer / Copier une rubrique.
• Supprimer une rubrique.
• Renommer une rubrique.

La génération de l'analyse intervient avant la phase de programmation et après la phase de description des fichiers de données. Cette génération permet de :

• valider les modifications effectuées sur l'analyse (MLD).
• créer les modules nécessaires à la programmation.
• mettre à jour automatiquement les fichiers de données si nécessaire.

Tant que l'analyse (le MLD) n'a pas été générée, la description de l'analyse (les fichiers de données) ne pourra pas être utilisée dans le projet.

• Vérification des modifications effectuées et génération des fichiers physiques correspondant à la description de l'analyse.
• Modification automatique des fichiers de données accessibles (fichiers présents dans le répertoire "EXE" du projet).
• Synchronisation du projet.

Pour gérer les différentes versions de l'analyse :

1. Sous le volet "Analyse", dans le groupe "Analyse", cliquez sur "Génération".
2. Sélectionnez l'option "Gestion des versions".
3. Dans l'assistant, indiquez si vous voulez travailler sur l'analyse en cours ou sur une analyse spécifique.

Remarque : lorsqu'une analyse est endommagée, il est possible de sélectionner directement l'analyse endommagée pour restaurer par exemple une des versions précédentes.

• un rectangle : il y a eu peu de modifications effectuées entre les deux versions.
• plusieurs rectangles : il y a eu plusieurs modifications effectuées entre les deux versions.

• Restauration d'une analyse.
• Annulation de la dernière génération.
• Remettre à 1 le numéro de version.

Restauration d'une analyse

Pour restaurer une analyse à partir du gestionnaire de versions :

1. Sélectionnez la version à restaurer.
2. Il est possible de :
   • soit restaurer la version dans le répertoire spécifié. Une analyse indépendante est créée correspondant à la version choisie. Cette option est sélectionnée par défaut.
   • soit écraser l'analyse en cours.
3. Validez. La restauration est effectuée.

Annulation de la dernière génération

L'annulation de la dernière génération de l'analyse permet de restaurer l'analyse dans son état avant la dernière génération. Les modifications effectuées depuis ne sont pas appliquées.

Remettre à 1 le numéro de la version

Il est possible de remettre le numéro de génération de l'analyse à "1" : sous le volet "Analyse", dans le groupe "Analyse", cliquez sur "Génération" et sélectionnez l'option "Remettre à 1 la version de l'analyse".