DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Connecteurs Natifs/Accès Natifs / Connecteur Natif Progress
  • Présentation
  • Configuration de l'administrateur ODBC
  • Remarque
  • Importation de la structure des fichiers
  • Les étapes de l'importation
  • Prendre en compte les évolutions de la base de données Progress
  • Programmation
  • 1. Ouverture de la connexion
  • 2. Exécution de requêtes
  • 3. Récupération du résultat
  • 4. Fermeture de la connexion
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 Progress : 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 Progress avec le Connecteur Natif (également appelé "Accès Natif"), il est nécessaire de :
  1. Configurer l'administrateur ODBC.
  2. Importer la structure des tables Progress dans l'analyse WINDEV ou WEBDEV.
Différences par rapport à la programmation SQL : Pour manipuler les données Progress, 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 Progress dans l'analyse WINDEV ou WEBDEV.
Configuration de l'administrateur ODBC
Pour configurer l'administrateur ODBC :
  1. Lancez l'administrateur de données ODBC (ODBCAD32.EXE) sur votre poste. Utilisez par exemple l'option "Démarrer .. Exécuter" de Windows et saisissez "ODBCAD32.EXE".
  2. Sélectionnez l'onglet "Base de données Utilisateur".
  3. Cliquez sur le bouton "Ajouter".
  4. Sélectionnez le driver ODBC pour Progress (installé avec la version client de Progress).
  5. Cliquez sur le bouton "Terminer".
  6. Saisissez le nom de la source de données Progress. Ce nom permettra d'identifier la base de données Progress dans vos programmes WINDEV ou vos sites WEBDEV.
  7. Validez (bouton "OK").

Remarque

Il est possible de se connecter à une base de données Progress sans déclarer de source ODBC. Dans ce cas, tous les paramètres de connexion doivent être fournis par la fonction HOuvreConnexion.
Par exemple, pour accéder à la base "Sports" située sur le serveur "Mars", en utilisant le service "srv_sports", la syntaxe de la fonction HOuvreConnexion devient :
// Définition d'une connexion
// Au mieux encore : utilisation du nom de la connexion définie dans l'analyse 
// (dans ce cas ne pas déclarer l'objet ici)
cnxProgress est une Connexion 

// Nom du serveur Progress
cnxProgress.Serveur = "Mars"
// Nom de la base de données
cnxProgress.BaseDeDonnées = "Sports"
// Utilisateur de la base
cnxProgress.Utilisateur = "sysprogress"
// Mot de passe de la base
cnxProgress.MotDePasse = "xxxx"
// Connecteur natif Progress
cnxProgress.Provider = hAccèsNatifProgress
// Informations Ã©tendues pour préciser le port et l'emplacement de la couche client Progress
cnxProgress.InfosEtendues = "PORT=srv_sports"
// Test de la connexion Ã  la base
SI PAS HOuvreConnexion(cnxProgress) ALORS
Erreur("Echec de la connexion Ã  la base", HErreurInfo())
FinProgramme()
FIN
Importation de la structure des fichiers

Les étapes de l'importation

Pour réaliser cette 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 Progress 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 Progress par programmation.
Dans les différents écrans de l'assistant, choisissez les options suivantes :
  • Type de base de données : Progress.
  • 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/WEBDEV. Ces tables pourront être manipulées par programmation grâce aux fonctions HyperFileSQL du WLangage. Ces tables apparaîtront en bleu sous l'éditeur d'analyses.
Si vous avez défini une source ODBC, il n'est pas nécessaire de préciser tous les paramètres dans la connexion (seule la source de données définie dans l'administrateur ODBC est nécessaire).
Si vous n'avez pas défini de source ODBC, il est nécessaire de saisir tous les paramètres dans la connexion :
  • Base de données,
  • Numéro ou nom de service sur lequel la database va répondre. Cette information doit être indiquée dans les paramètres avancés de la connexion (informations étendues), ...

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

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 uniquement pour les tables importées.
  • soit d'analyser les différences pour toutes les tables Progress.
Programmation

1. Ouverture de la connexion

Pour ouvrir la connexion à la base de données Progress, 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 de WINDEV et WEBDEV.
  • 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, "MaBaseProgress")
    HExécuteRequêteSQL(ReqClient, "MaBaseProgress", 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.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

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