DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV 28 !
  • Ce que vous allez apprendre dans cette leçon
  • Présentation
  • 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 utiliser une base de données HFSQL Client/Serveur
  • Présentation
  • Adaptation de l'exemple
  • Fonctionnalités disponibles en mode HFSQL Client/Serveur
Leçon 5.2. Mise en place d'une base de données Client/Serveur
Ce que vous allez apprendre dans cette leçon
  • 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.
  • Fonctionnalités disponibles en mode Client/Serveur.
Durée de la leçon

Durée estimée : 10 mn
Leçon précédenteSommaireLeçon suivante
Présentation
Dans cette leçon, 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.
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.

    Note

    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.

    Note

    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.

    Attention !

    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.
  13. 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.
Création d'une application utilisant une base de données HFSQL Client/Serveur
La création d'une application WINDEV utilisant une base de données HFSQL Client/Serveur se fait très simplement. Il est nécessaire de :
  1. Créer le projet en demandant à créer une nouvelle base de données.
  2. Créer l'analyse en spécifiant que les bases de données utilisées par le projet seront de type "HFSQL Client/Serveur".
  3. Indiquer les caractéristiques de la connexion au serveur HFSQL Client/Serveur à utiliser.
  4. Lors de la création d'un fichier de données sous l'analyse, indiquer que ce fichier de données est en mode Client/Serveur et préciser la connexion utilisée.

Note

Vous pouvez aussi décrire la connexion au serveur HFSQL par programmation. Pour plus de détails, consultez l'aide en ligne : HDécritConnexion.
Adaptation d'une application pour utiliser une base de données HFSQL Client/Serveur

Présentation

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 que nous avons réalisée dans la partie 4 de ce tutorial, en utilisant la première méthode, l'éditeur d'analyses.

Adaptation de l'exemple

Nous allons adapter notre projet "WD Application complète" (créé dans la partie 4 de ce tutoriel) pour qu'il utilise une base de données HFSQL Client/Serveur.

  • Ré-ouvrez si nécessaire le projet que vous avez manipulé dans la leçon précédente.
    1. Affichez la page d'accueil de WINDEV (Ctrl + <).
    2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Partie 5 - Administrer une base HFSQL Client/Serveur", double-cliquez sur "Application complète (Exercice)".
    3. WINDEV vous propose d'ouvrir le projet que vous avez manipulé dans la leçon précédente. Vous pouvez ouvrir le projet présent sur votre poste ou ouvrir le projet original. Choisissez "Ouvrir la copie locale".

Corrigé

Un projet corrigé est disponible. Ce projet permet d'effectuer les manipulations réalisées dans cette leçon. Pour ouvrir le projet corrigé, dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Partie 5 - Administrer une base HFSQL Client/Serveur", double-cliquez sur "Application complète (Corrigé)".


  • Pour adapter le projet :
    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.
      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.

      Note

      Passage en mode Client/Serveur : quelques conseils
      • Vérifiez le code de votre projet : en mode HFSQL Client/Serveur, les instructions 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.
Fonctionnalités disponibles en mode HFSQL Client/Serveur
HFSQL Client/Serveur propose de nombreuses fonctionnalités :
Nous ne détaillerons pas ici ces fonctionnalités (certaines ont été abordées dans ce cours en mode HFSQL Classic).
Leçon précédenteSommaireLeçon suivante
Version minimum requise
  • Version 28
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire