DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Connecteurs Natifs/Accès Natifs / Connecteur Natif DB2
  • Présentation
  • Importation de la structure des fichiers
  • Les étapes de l'importation
  • Prendre en compte les évolutions de la base de données DB2
  • Programmation
  • 1. Ouverture de la connexion
  • 2. Exécution de requêtes
  • 3. Récupération du résultat
  • 4. Fermeture de la connexion
  • Optimisation des fonctions HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Connecteur Natif DB2 : Programmation à l'aide des fonctions HFSQL
Connecteurs Natifs (Accès Natifs)Disponible uniquement avec ce type de connexion
Présentation
Pour utiliser une base de données DB2 avec le Connecteur Natif (également appelé "Accès Natif"), il est nécessaire d'importer la structure des tables DB2 dans l'analyse WINDEV ou WEBDEV.
Différences par rapport à la programmation SQL : Pour manipuler les données DB2, 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 DB2 dans l'analyse WINDEV ou WEBDEV.
Importation de la structure des fichiers

Les étapes de l'importation

  1. Lancez l'éditeur d'analyses : cliquez sur Charger l'analyse du projet parmi les boutons d'accès rapide.
  2. 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 DB2 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 DB2 par programmation.
Dans les différents écrans de l'assistant, choisissez les options suivantes :
  • Type de base de données : DB2.
  • 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 DB2

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 DB2.
Programmation

1. Ouverture de la connexion

Pour ouvrir la connexion à la base de données DB2, 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.
Pour modifier certains paramètres de cette connexion (par exemple le nom d'utilisateur ou le mot de passe), utilisez la fonction HConnecte.
Remarque : Si vous tentez de lire directement le fichier (fonction HLitPremier, ...), la connexion associée à la description du fichier dans l'analyse sera automatiquement ouverte.

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, "BaseDB2", hRequêteSansCorrection)
HExécuteRequêteSQL(ReqClient, "BaseDB2", 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, ...

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.

Optimisation des fonctions HFSQL

  • Les champs de type "Table fichier" basés sur des requêtes sont optimisés : il est possible de trier le contenu du champ Table en cliquant sur une de ses colonnes.
  • Pour éviter de ré-exécuter plusieurs fois la même requête lors du parcours de son résultat, il est conseillé d'utiliser la constante hSansRafraîchir (par exemple si un seul poste modifie les données).
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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