DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WEBDEV 2024 !
Aide / Tuto WEBDEV / Tuto - Administrer 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'un site 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 - Administrer 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'un site utilisant une base de données HFSQL Client/Serveur.
  • Adaptation d'un site pour gérer une base de données HFSQL Client/Serveur.
Durée de la leçon 10 mn
Présentation
WEBDEV permet de créer des applications/sites accédant à des bases 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 poste serveur peut être différent de celui où est déployé le site). 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,
  • permet des connexions depuis l'extérieur (siège par le back office par exemple).
Dans cette leçon, nous allons effectuer toutes les opérations nécessaires au développement et au déploiement d'un site utilisant une base de données HFSQL 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 ou directement sur le serveur hébergeant votre site.
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 WEBDEV et d'une analyse, consultez le tuto Créer un projet WEBDEV et son analyse.
Adaptation d'un site 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.
WEBDEV 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 le site "Site WEBDEV complet" 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 WEBDEV (Ctrl + <).
  2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Administrer une base HFSQL Client/Serveur", double-cliquez sur "Site WEBDEV Complet - Corrigé".
Avertissement
Cet exemple sera utilisé dans les différentes leçons de ce tuto.

Adaptation du projet

Pour adapter le projet "Site WEBDEV Complet" :
  1. 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 du menu de WEBDEV. L'éditeur d'analyses s'affiche.
  2. Dans le ruban, sous le volet "Analyse", dans le groupe "Connexion", cliquez sur "Nouvelle connexion". Un assistant s'ouvre, permettant de créer une connexion.
  3. Sélectionnez le type de connexion à créer : "HFSQL Client/Serveur".
    Sélection du type de la base de données
    Passez à l'étape suivante.
  4. Indiquez dans les étapes suivantes :
    Choix du serveur
    • le nom du serveur sur lequel vous avez installé le serveur HFSQL Client/Serveur (localhost si vous l'avez installé sur votre machine par exemple) et le numéro de port.
    • le nom de l'utilisateur et son mot de passe (pour utiliser l'administrateur, spécifier le login et le mot de passe personnalisés lors de l'installation du serveur HFSQL).
    • le nom de la base de données ("Site_WEBDEV_Complet" dans notre exemple).
    • le nom de la connexion (conservez le nom proposé).
  5. Passez à l'étape suivante et validez. La connexion à la base 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.
    Association des fichiers de données à la connexion
  6. Cliquez sur "Oui".
  7. Dans l'étape suivante, sélectionnez tous les fichiers de données proposés :
    Choix des fichiers de données
    Passez à l'étape suivante.
  8. L'assistant propose ensuite de copier les fichiers de données sur le serveur. Validez (option "Copier maintenant").
    Copie des fichiers de données
  9. 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.
    Copie des fichiers de données
  10. Passez à l'étape suivante et validez.
  11. 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
  12. Générez l'analyse : Dans le ruban, sous le volet "Analyse", 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 instructions de type HSubstRep et autres 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.
  13. Vous avez adapté le projet de développement. Il peut être également nécessaire d'adapter le site déployé (par exemple si le site déployé utilise des fichiers de données HFSQL Classic). Cette opération se paramètre lors de la création du programme d'installation du site.
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 WEBDEV 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 un site 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 : 22/11/2023

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