PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Importation de la structure des fichiers
  • Les étapes de l'importation
  • Prendre en compte les évolutions de la base de données MySQL
  • Programmation
  • 1. Ouverture de la connexion
  • 2. Exécution de requêtes
  • 3. Récupération du résultat
  • 4. Fermeture de la connexion
  • Astuce sous Linux
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Accès Natif MySQL : Programmation à l'aide des fonctions HFSQL
Accès NatifsDisponible uniquement avec ce type de connexion
Présentation
Pour utiliser une base de données MySQL avec l'Accès Natif, il est nécessaire d'importer la structure des tables MySQL dans l'analyse WINDEV ou WEBDEV.
Différences par rapport à la programmation SQL : Pour manipuler les données MySQL, les requêtes ne sont pas obligatoires. En effet, vous pouvez directement utiliser les fonctions HFSQL pour lire vos données, effectuer des recherches, des filtres, ... Cependant, il est nécessaire d'importer la structure des fichiers MySQL dans l'analyse WINDEV ou WEBDEV.
Remarque : Les requêtes exécutées avec HExécuteRequête et HExécuteRequêteSQL sont automatiquement "corrigées" pour être compatibles avec MySQL.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Importation de la structure des fichiers

Les étapes de l'importation

Pour réaliser cette importation :
  1. Ouvrez l'éditeur d'analyses (option "Projet .. Charger l'analyse"). Lancez l'éditeur d'analyses : cliquez sur parmi les boutons d'accès rapide.
  2. Sous l'éditeur d'analyses, sélectionnez l'option "Structure de fichiers .. Importer des descriptions de fichiers / tables".Sous le volet "Analyse", dans le groupe "Création", déroulez "Importer" et sélectionnez "Importer des descriptions de fichiers / tables".
  3. L'assistant se lance. Une connexion à la base de données MySQL est automatiquement créée et associée aux fichiers importés dans l'analyse. Cette connexion devra être utilisée pour manipuler le fichier de données MYSQL par programmation.
Dans les différents écrans de l'assistant, choisissez les options suivantes :
  • Source de données : Base externe.
  • L'application utilisera les données dans le format actuel.
  • Sélectionnez le type "Accès Natif pour MySQL", la source de données, le nom de l'utilisateur et le mot de passe. Le bouton "Propriété" permet d'accéder aux propriétés systèmes.
  • Lorsque la connexion est établie, il suffit de sélectionner les tables à importer dans l'analyse WINDEV ou WEBDEV. Ces tables pourront être manipulées par programmation grâce aux fonctions HFSQL du WLangage. Ces tables apparaîtront en bleu sous l'éditeur d'analyses.
Dans les différents écrans de l'assistant, choisissez les options suivantes :
  • Type de base de données : MySQL.
  • Caractéristiques de la connexion : Serveur de données, Utilisateur et mot de passe, base de données.
  • L'application accédera aux données dans le format actuel.
  • Lorsque la connexion est établie, il suffit de sélectionner les tables à importer dans l'analyse WINDEV ou WEBDEV. Ces tables pourront être manipulées par programmation grâce aux fonctions HFSQL du WLangage. Ces tables apparaîtront en bleu sous l'éditeur d'analyses.

Prendre en compte les évolutions de la base de données MySQL

Pour prendre en compte les évolutions des tables importées sous l'éditeur d'analyses, sélectionnez l'option "Structure de fichiers .. Synchroniser l'analyse avec les bases de données externes". Pour prendre en compte les évolutions des tables importées sous l'éditeur d'analyses, sous le volet "Analyse", dans le groupe "Analyse", déroulez "Synchronisation" et sélectionnez "Mettre à jour l'analyse depuis les bases de données externes".
Un assistant se lance et permet au choix :
  • soit d'analyser les différences pour les tables importées,
  • soit d'analyser les différences pour toutes les tables MySQL.
Programmation

1. Ouverture de la connexion

Pour ouvrir la connexion à la base de données MySQL, utilisez la fonction HOuvreConnexion en précisant le nom de la connexion à ouvrir. Ce nom de connexion a été défini lors de l'importation de la structure des fichiers dans l'analyse.
Attention : Si vous utilisez une autre syntaxe, le nom de la database à utiliser doit être spécifié.
Pour modifier certains paramètres de cette connexion (par exemple le nom d'utilisateur ou le mot de passe), utilisez la fonction HConnecte.
Remarques :
  • Si vous tentez de lire directement le fichier (fonction HLitPremier, ...), la connexion associée à la description du fichier dans l'analyse sera automatiquement ouverte.
  • Il est possible de fixer les paramètres "Server Port", "Unix Socket" et "Client Flag" pour la connexion au serveur MySQL. Il suffit d'ajouter les chaînes correspondantes dans les informations étendues de la connexion (fonctions HDécritConnexion ou HOuvreConnexion).
    Exemple 1 : "Server Port=3306;" pour se connecter sur le port 3306 du serveur MySQL.
    Exemple 2 : "Server Port=3306; Client Flag=0;"
    ...
    Pour plus de détails sur ces paramètres, consultez la documentation de MySQL (mot-clé = 'mysql_real_connect').
  • Il est possible de paramétrer lors de la connexion la gestion ou non des rubriques Unicode. Il suffit d'ajouter dans les informations étendues de la connexion (fonctions HDécritConnexion ou HOuvreConnexion) l'option "WD Unicode Support".
    • Si "WD Unicode Support = 0", la gestion de Unicode est désactivée sur la connexion. Le serveur convertira lui-même si nécessaire toutes les valeurs dans l'alphabet utilisé par défaut. Dans ce cas, les performances sont meilleures, mais la gestion des rubriques Unicode n'est pas disponible.
    • Si "WD Unicode Support = 1" (valeur pas défaut), la gestion de Unicode est activée sur la connexion. Tous les échanges avec le serveur sont réalisés en Unicode. L'accès natif gère les conversions éventuellement nécessaires.
  • Il est possible de spécifier la taille du cache dans les informations optionnelles de la connexion avec le mot-clé suivant "WD Cache Size". Dans ce cas, le paramètre fixé avec la propriété ..CxTailleCache est ignoré.
    Exemple :
    "WD Cache Size = 10000; Server Port=3306;"

2. Exécution de requêtes

Les fonctions HExécuteRequête et HExécuteRequêteSQL permettent d'exécuter des requêtes sur la base de données en cours.
  • HExécuteRequête : permet d'exécuter une requête prédéfinie avec l'éditeur de requêtes.
  • HExécuteRequêteSQL : permet d'exécuter une requête en précisant directement le code SQL de la requête, et le nom qui sera attribué à ce code SQL.
// Initialisation de la requête "Client_84"
HExécuteRequête(CLIENT_84, "BaseMYSQL", hRequêteSansCorrection)
HExécuteRequêteSQL(ReqClient, "BaseMYSQL", hRequêteSansCorrection, ...
"SELECT NOM FROM CLIENT")

3. Récupération du résultat

Le parcours du résultat est réalisé avec toutes les fonctions de lecture classiques : HLitPremier, HLitSuivant, HLitRecherche, ...
Il n'est pas possible dans cette version de bloquer les enregistrements grâce aux options de blocage de ces fonctions. Seuls les blocages réalisés avec SQLBloque sont gérés (voir Accès natif MySQL : gestion des blocages et des transactions).

4. Fermeture de la connexion

La fonction HFermeConnexion permet de fermer la connexion à la base de données lorsque toutes les requêtes nécessaires ont été réalisées.
Astuce sous Linux
WINDEVWEBDEV - Code ServeurLinuxAccès Natifs Les erreurs ne pouvant pas être affichées sous Linux dans des fenêtres ou des pages, il est nécessaire de renvoyer les erreurs dans la console en utilisant la fonction dbgSortieStandard.
Par exemple :
SI PAS HOuvreConnexion(Ma_Connexion) ALORS
        dbgSortieStandard(HErreurInfo(hErrComplet))
FIN
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire