Tuto - Utiliser une base HFSQL Client/Serveur

Maintenant que nous savons créer/adapter une application pour qu'elle fonctionne en mode HFSQL Client/Serveur, nous allons voir comment administrer la base de données associée.

• une configuration spécifique des postes (installation d'un serveur HFSQL, etc.).
• une administration réalisée grâce au Centre de Contrôle HFSQL.

Pour utiliser une base HFSQL Client/Serveur, il est nécessaire d'installer un serveur HFSQL sur le poste serveur. Il est possible d'utiliser plusieurs serveurs HFSQL sur le même poste, utilisant des ports différents.

Le Centre de Contrôle HFSQL permet de réaliser toutes les opérations d'administration des serveurs et des bases de données HFSQL Client/Serveur.

Lancement du Centre de Contrôle HFSQL

Pour lancer le Centre de Contrôle HFSQL depuis WINDEV et accéder aux données :

1. Dans le menu de WINDEV, sous le volet "Outils", dans le groupe "Base de données", cliquez sur "HFSQL". Le Centre de Contrôle HFSQL apparaît.
2. La fenêtre de bienvenue dans le Centre de Contrôle HFSQL s'affiche. L'analyse du projet en cours est automatiquement sélectionnée.
   
3. Validez. Le Centre de contrôle HFSQL apparaît. Ce mode de lancement permet de voir les différents fichiers de données liés à l'analyse du projet en cours.
4. Cliquez si nécessaire sur l'onglet vertical "HFSQL C/S". La liste des fichiers de données au format HFSQL Client/Serveur s'affiche.
   
   Le Centre de Contrôle liste ici les fichiers de données Client/Serveur trouvés dans l'analyse liée au projet en cours. Aucune connexion n'est réalisée : les fichiers de données apparaissent grisés.
5. Pour visualiser les enregistrements présents dans les fichiers de données, double-cliquez sur un des fichiers de données dans la liste à gauche (par exemple "Commande"). Si le Centre de Contrôle HFSQL ne connaît pas tous les paramètres de la connexion, une fenêtre de connexion permet de réaliser la connexion effective au serveur HFSQL Client/Serveur utilisé. Si cette fenêtre s'affiche, indiquez le mot de passe et validez.
6. Les différentes informations sur le fichier de données sélectionné et utilisant cette connexion sont affichées dans un nouveau volet "Commande". Ce volet présente ces informations dans plusieurs onglets verticaux :
   
   • L'onglet "Description" présente les informations sur les fichiers de données (clés et autres rubriques du fichier de données, etc.).
   • L'onglet "Contenu" affiche les enregistrements contenus dans les fichiers de données.

Nous avons vu que lors de l'installation d'un serveur HFSQL, un seul compte utilisateur est créé : le compte de l'administrateur (login "Admin" sans mot de passe).

• Nous connecter à la base de données présente sur le serveur HFSQL.
• Créer un utilisateur.
• Donner différents droits à l'utilisateur.

Connexion à la base de données HFSQL Client/Serveur

Pour se connecter directement à la base de données WD Application Complète présente sur le serveur HFSQL :

1. Déroulez le menu situé en haut à gauche du Centre de Contrôle HFSQL et sélectionnez l'option "Se connecter à un serveur HFSQL".
2. La fenêtre de bienvenue dans le Centre de Contrôle HFSQL s'affiche.
   
3. L'option "Se connecter à un serveur HFSQL" est sélectionnée par défaut. Indiquez les caractéristiques du serveur installé dans la leçon précédente puis validez.
4. Les caractéristiques du serveur HFSQL sont affichées.

• dans le panneau de gauche, le nom du serveur HFSQL ainsi que la liste des bases présentes sur ce serveur apparaissent.
• dans la partie droite, un nouvel onglet est affiché permettant de voir les caractéristiques du serveur HFSQL.
  

Création d'un utilisateur

Pour créer un nouvel utilisateur :

1. Dans la partie droite de l'écran, sélectionnez l'onglet "Utilisateurs". Cet onglet permet de gérer les utilisateurs du serveur.
   Pour le moment, seul l'utilisateur "Admin" est présent.
   
2. Dans le menu, dans le groupe "Utilisateurs", cliquez sur le bouton "Nouveau". La fenêtre permettant de définir les caractéristiques de l'utilisateur apparaît.
3. Saisissez par exemple les informations suivantes :
   
   (utilisez par exemple "Test" également comme mot de passe).
   
   

   Plusieurs caractéristiques peuvent être notées :

   • Super Utilisateur : Les utilisateurs désignés comme "Super utilisateur" sont autorisés à effectuer toutes les actions sur le serveur, les bases de données et sur tous les fichiers de données.
   • Compte actif : Si cette option n'est pas cochée, l'utilisateur existe mais n'est pas actif (cas des utilisateurs en congés par exemple).
   • Expiration du mot de passe : Il est possible d'avoir un mot de passe valide uniquement pour un nombre de jours donnés (paramétrable).
4. Validez la création de l'utilisateur. Par défaut, cet utilisateur n'a aucun droit.

Sélection des droits pour le nouvel utilisateur

Nous allons maintenant attribuer des droits à l'utilisateur : l'utilisateur "Test" peut se connecter à la base de données et consulter le fichier de données Client.

1. Dans le Centre de Contrôle HFSQL, double-cliquez sur la base de données "WD Application Complète".
2. Sous le volet "WD Application Complète", dans le groupe "Droits", cliquez sur "Gestion des droits".
3. Sélectionnez l'utilisateur "Test" dans la liste des utilisateurs.
4. Dans la liste des droits, pour l'action "Droit de se connecter au serveur (connexion cryptée et non cryptée)", cliquez dans la colonne "Droit défini" et sélectionnez la coche verte.
   
5. Cliquez sur le bouton "Appliquer" présent en bas de la fenêtre. Le droit devient effectif.
6. Fermez la fenêtre de gestion des droits.

1. Dans le Centre de Contrôle HFSQL, déroulez la base de données "WD Application Complète", puis double-cliquez sur le fichier de données Client (à gauche de l'écran).
2. Sous le volet "Client", dans le groupe "Droits", cliquez sur "Gestion des droits".
3. Sélectionnez l'utilisateur "Test" dans la liste des utilisateurs.
4. Dans la liste des droits, pour l'action "Droit de lire les enregistrements d'un fichier", cliquez dans la colonne "Droit défini" et sélectionnez la coche verte.
   
5. Cliquez sur le bouton "Appliquer" présent en bas de la fenêtre. Le droit devient effectif.
6. Fermez la fenêtre de gestion des droits.

Une fois le compte créé, il peut être utilisé lors de la connexion de l'application au serveur avec la fonction HOuvreConnexion.
Dans notre exemple, l'utilisateur "Test" pourra uniquement parcourir les enregistrements du fichier de données Client. Si cet utilisateur tente une autre action, un message s'affichera : "L'utilisateur Test n'a pas les droits suffisants pour XXXX" (où XXXX correspond à l'action effectuée).

Nous venons de voir quelques fonctionnalités de base du Centre de Contrôle HFSQL. Cet outil complet d'administration de base de données permet entre autres :

• d'arrêter ou de redémarrer un serveur en cas de problème,
• de gérer les utilisateurs et leurs droits,
• de réindexer les fichiers de données si nécessaire,
• de faire des sauvegardes de la base.

• Nous avons vu dans cette leçon que la gestion des utilisateurs pouvait être effectuée à l'aide du Centre de Contrôle HFSQL. La gestion des utilisateurs et de leurs droits peut également être effectuée par programmation grâce aux fonctions WLangage.
  Pour plus de détails, consultez Fonctions de gestion de HFSQL Client/Serveur.
• Pour connaître toutes les fonctionnalités du Centre de Contrôle HFSQL, consultez Centre de Contrôle HFSQL : Présentation.