DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV 2024 !
Aide / Tuto WINDEV / Tuto - Utiliser une base HFSQL Client/Serveur
  • Leçon 1 - Mise en place d'une base de données Client/Serveur
  • Présentation
  • Installation d'un serveur HFSQL local
  • Adaptation d'une application pour utiliser une base de données HFSQL Client/Serveur
  • Ouverture du projet exemple
  • Adaptation du projet
  • En résumé
  • Pour aller plus loin

Tuto - Utiliser une base HFSQL Client/Serveur

Leçon 1 - Mise en place d'une base de données Client/Serveur
Ce que vous allez apprendre :
  • Installation d'un serveur HFSQL local.
  • Création d'une application utilisant une base de données HFSQL Client/Serveur.
  • Adaptation d'une application pour gérer une base de données HFSQL Client/Serveur.
Durée de la leçon 10 mn
Présentation
WINDEV permet de créer des applications accédant à une base de données HFSQL Client/Serveur.
Une base de données en mode Client/Serveur permet de déporter la ou les bases de données sur un poste serveur. Ce mode de fonctionnement :
  • accroît la sécurité de vos données,
  • permet de gérer très facilement le mode multi-utilisateurs,
  • facilite la maintenance, etc.
Dans ce tuto, nous allons effectuer toutes les opérations nécessaires au développement et au déploiement d'une application utilisant une base de données HFSQL Client/Serveur.
Les manipulations seront effectuées sur le projet "WD Application Complète". Cette leçon va nous permettre d'installer un serveur HFSQL local, puis d'adapter une application pour utiliser une base de données HFSQL Client/Serveur. La leçon suivante permettra de nous concentrer sur l'administration de la base Client/Serveur.
Pour plus de détails sur HFSQL Client/Serveur, consultez HFSQL Client/Serveur.
Installation d'un serveur HFSQL local
La première opération à faire avant de commencer à développer consiste à installer un serveur HFSQL.
Sur le poste de développement, ce serveur peut être installé en local (c'est ce que nous allons faire). En déploiement, ce serveur peut être installé sur un poste spécifique.
Le programme d'installation du serveur HFSQL est disponible sur le support d'installation de WINDEV, WEBDEV et WINDEV Mobile. Si vous ne possédez pas ce support, l'installation du serveur HFSQL est également disponible sur le site de PC SOFT (www.pcsoft.fr).
Pour installer le serveur HFSQL en local :
  1. Lancez le programme d'installation de WINDEV, WEBDEV et WINDEV Mobile.
  2. Choisissez l'option "Installer HFSQL Client/Serveur".
  3. Sélectionnez ensuite l'option "Installer ou mettre à jour un serveur HFSQL".
  4. Acceptez la licence.
  5. Choisissez la plateforme (option "Pour Windows sur cette machine").
  6. Si des serveurs HFSQL sont déjà installés sur le poste en cours, choisissez l'option "Installer un nouveau serveur".
  7. Sélectionnez le répertoire d'installation et indiquez le nom du serveur et le port. Par défaut, le port utilisé est 4900.
    Pensez à ouvrir ce port sur le firewall pour se connecter au serveur HFSQL depuis une autre machine.
  8. Indiquez le nom et le mot de passe de l'utilisateur ayant les droits d'administration qui sera créé par défaut sur le serveur HFSQL. Par défaut, cet utilisateur est "Admin" sans mot de passe.
    Pour des raisons évidentes de sécurité, pensez à changer le mot de passe de l'administrateur.
  9. Installez le Centre de Contrôle HFSQL si celui-ci n'est pas présent ou accessible depuis votre poste.
    Avertissement
    Le Centre de Contrôle HFSQL est nécessaire à la gestion de la base HFSQL Client/Serveur.
  10. L'assistant propose de paramétrer l'envoi de notifications afin de connaître les dysfonctionnements du serveur en temps réel. Pour notre exemple, passez à l'étape suivante et indiquez que le paramétrage sera effectué "Plus tard".
  11. L'assistant propose d'activer l'authentification par Active Directory. Activez cette option si nécessaire.
  12. Validez (ou non) la participation à l'amélioration du produit installé en autorisant la collecte d'informations relatives à l'utilisation du produit. Cette collecte, facultative et anonyme, permet à PC SOFT d'améliorer les fonctionnalités du produit.
L'installation est effectuée.
Par défaut (si vous n'avez pas modifié les caractéristiques de l'administrateur), pour se connecter au serveur en mode administrateur, il faut utiliser l'utilisateur "Admin" sans mot de passe.

Remarque : Dans ce tuto, nous nous attachons à l'adaptation d'une application existante au mode Client/Serveur. Lorsque le serveur HFSQL est installé, il est bien entendu également possible de développer directement une nouvelle application utilisant des données HFSQL Client/Serveur. Pour cela, la seule différence avec la création d'un projet utilisant des données HFSQL Classic, correspond au format des données manipulées dans l'analyse : les bases de données utilisées par le projet seront de type "HFSQL Client/Serveur".
Pour plus de détails sur la création d'un projet WINDEV et d'une analyse, consultez le tuto Créer un projet WINDEV et son analyse.
Adaptation d'une application pour utiliser une base de données HFSQL Client/Serveur
Le passage d'une base de données HFSQL Classic en mode Client/Serveur est l'opération la plus courante.
WINDEV propose plusieurs solutions pour réaliser ce passage :
  • réaliser cette adaptation dans l'éditeur d'analyses.
  • réaliser cette adaptation depuis le Centre de Contrôle HFSQL.
Pour mieux se rendre compte des différentes étapes, nous allons passer en mode Client/Serveur l'application WD Application Complète, en utilisant la première méthode, l'éditeur d'analyses.

Ouverture du projet exemple

Ce tuto manipule le projet "WD Application Complète". Pour ouvrir cet exemple :
  1. Affichez la page d'accueil de WINDEV (Ctrl + <).
  2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Application WINDEV : gérer des données", double-cliquez sur "Application complète - Corrigé".
Avertissement
Cet exemple sera utilisé dans les différentes leçons de ce tuto.

Adaptation du projet

Pour adapter le projet "WD Application Complète" :
  1. Dans le volet "Explorateur de projet", sélectionnez si nécessaire, la configuration de projet "Exécutable Windows 32 bits".
  2. Chargez l'analyse de votre projet sous l'éditeur d'analyses : cliquez sur Charger l'analyse du projet parmi les boutons d'accès rapide. L'éditeur d'analyses s'affiche.
  3. Sous le volet "Analyse" du ruban, dans le groupe "Connexion", cliquez sur "Nouvelle connexion". Un assistant s'ouvre, permettant de créer une connexion.
  4. Sélectionnez le type de connexion à créer : "HFSQL Client/Serveur".
    Type de connexion à créer
  5. Passez à l'étape suivante.
  6. Indiquez dans les étapes suivantes :
    Choix du serveur
    • le nom du serveur (nom de votre machine par exemple) et le numéro de port.
    • le nom de l'utilisateur et son mot de passe (laissez ces informations vides pour utiliser l'administrateur).
    • le nom de la base de données ("WD Application Complète" dans notre exemple).
    • le nom de la connexion (conservez le nom proposé).
  7. Passez à l'étape suivante et validez. La connexion à la base de données est automatiquement créée. L'assistant propose d'associer les différents fichiers de données présents dans l'analyse à la connexion qui vient d'être créée.
    Associer les fichiers à la connexion
  8. Cliquez sur "Oui".
  9. Dans l'étape suivante, sélectionnez tous les fichiers de données proposés :
    Choix des fichiers de données
    Passez à l'étape suivante.
  10. L'assistant propose ensuite de copier les fichiers de données sur le serveur. Validez (option "Copier maintenant").
    Copie immédiate
  11. Sélectionnez les fichiers de données de l'analyse à copier sur le serveur : dans notre cas, ce sont tous les fichiers de données du répertoire "EXE\Exécutable Windows 64 bits".
    Avertissement
    Il existe deux configurations de projet pour ce projet : une configuration 64 bits et une configuration 32 bits (nécessaire pour la version Express).
    Veillez à bien sélectionner les fichiers de la configuration 64 bits.
    Si vous utilisez la version Express, seuls les fichiers de la configuration 32 bits doivent être sélectionnés.
    Fichiers de données à associer à la connexion
  12. Passez à l'étape suivante et validez.
  13. Les fichiers de données de l'analyse sont automatiquement transformés en fichiers de données HFSQL Client/Serveur et associés à la connexion choisie.
    Editeur d'analyses
  14. Générez l'analyse : sous le volet "Analyse" du ruban, dans le groupe "Analyse", cliquez sur "Génération". Une modification automatique des fichiers de données est automatiquement proposée. Si tous les fichiers de données sont à jour, vous pouvez annuler la modification automatique des fichiers de données.
    Passage en mode Client/Serveur : quelques conseils
    • Vérifiez le code de votre projet : en mode HFSQL Client/Serveur, les fonctions telles que la fonction HSubstRep sont inutiles.
    • Selon les paramètres indiqués lors de la création de la connexion, il est possible de modifier la connexion définie dans l'analyse grâce aux fonctions HOuvreConnexion et HChangeConnexion.
    • La fonction HOuvreConnexion permet toujours de repasser en mode HFSQL Classic : il suffit de lui préciser le chemin du répertoire contenant les fichiers de données HFSQL Classic.
  15. Vous avez adapté le projet de développement. Il peut être également nécessaire d'adapter l'application déployée (par exemple si l'application déployée utilise des fichiers de données HFSQL Classic). Cette opération se paramètre lors de la création du programme d'installation de l'application. La création du programme d'installation est abordée dans la leçon 3 de ce tuto.
En résumé
Cette leçon nous a permis de voir comment installer un serveur HFSQL en local. Nous avons ainsi pu adapter un projet WINDEV afin de gérer une base de données HFSQL Client/Serveur.
La prochaine leçon nous permettra d'aborder le côté "administration" de la base de données HFSQL Client/Serveur.
Pour aller plus loin
Dans cette leçon, nous avons vu comment adapter une application pour utiliser une base de données HFSQL Client/Serveur. HFSQL Client/Serveur propose de nombreuses fonctionnalités spécifiques que nous ne détaillerons pas dans ce tuto :
SommaireLeçon suivante
Version minimum requise
  • Version 2024
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 08/12/2023

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