PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version : 19.0
Votre version : XXA150056M

  • Présentation
  • Configuration du serveur d'accès distant
  • Programmation
  • Accès à la base de données
  • Utilisation des fonctions HDécritConnexion et HChangeConnexion
  • Fonctions HFSQL pouvant être utilisées en Accès distant
  • Optimisations
WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et RequêtesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidWidget AndroidiPhone/iPadJavaPHPAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBODBCAccès Natifs
Connexion à une base de données via RPC

Présentation
L'accès distant permet d'accéder à n'importe quel type de base de données.

Il suffit de créer une analyse accédant à la base de données tierce, soit grâce aux accès natifs, soit grâce à OLE DB/ODBC. Cette analyse va être déployée sur le serveur.

Il suffit ensuite de paramétrer un serveur d'accès distant sur le poste serveur. Dans le cas d'une application mobile, le terminal mobile va utiliser l'analyse du poste serveur grâce à l'accès distant.

Configuration du serveur d'accès distant
Les différentes étapes de la configuration du serveur sont les suivantes :
  1. Installation de l'application "WDServeurAccesDistant" sur le poste serveur.
    • Le serveur nécessite les DLL suivantes du framework WinDev : wdxxximg, wdxxxvm, wdxxxobj, wdxxxhf, wdxxxsql, wdxxxstd, wdxxxcom, wdxxxprn, wdxxxetat, wdxxxoldb, wdxxxmat.dll, wdxxxpnt ainsi que le composant WDOutil.wdk.
    • Il est nécessaire de copier ces éléments depuis le répertoire "Programmes" de WinDev vers le poste serveur.
  2. Lancement de l'application "WDServeurAccesDistant" sur le poste serveur.
  3. Sélection de l'analyse (fichier .wdd) correspondant aux données accédées via l'accès distant dans l'onglet "Analyses" (bouton "Configuration"). Cette sélection est réalisée dans l'application "WDServeurAccesDistant".
  4. Définition de la liste des utilisateurs autorisés à accéder aux données via l'accès distant (onglet "Utilisateurs" de "WDServeurAccesDistant").
  5. Configuration si nécessaire des éléments suivants :
    • Port de communication
    • Gestion du cryptage
    • Démarrage automatique, ...
  6. Démarrage du serveur. Lorsque le serveur est démarré, le serveur d'accès distant est opérationnel et autorise la connexion des applications clientes.

Programmation

Accès à la base de données

Pour accéder à la base de données grâce à l'accès distant, il suffit d'ouvrir l'analyse grâce à la fonction HOuvreAnalyse du WLangage. Par exemple :

// Ouverture de l'analyse distante
HOuvreAnalyse("MonAnalyse.wdd", "", SAI_AdresseIP, SAI_User, SAI_MDP)

L'accès aux données s'effectue grâce aux fonctions Hxxx :

// Initialisation de la table
HLitPremier(Client, Nom)
TANTQUE HEnDehors() = Faux
        ...
        HLitSuivant(Client)
FIN

Utilisation des fonctions HDécritConnexion et HChangeConnexion

Lors de l'utilisation de l'accès distant, il est possible d'utiliser les fonctions HDécritConnexion et HChangeConnexion. Par exemple :

// Connexion au serveur RPC
HConnecteAccèsDistant("192.168.1.1", "User", "MotPasseUser", ...
"C:\GESTCOM\GESTCOM.WDD", "MotPasseGestcom")
HDécritConnexion("MaConnexion", "", "", "Serveur_SQLServer", "dbo", ...
hAccèsNatifSQLServer, hOLectureEcriture, "")
HChangeConnexion("*", "192.168.1.1")
WinDevWebDev - Code ServeurWinDev MobileEtats et RequêtesWindowsWindows Mobile

Fonctions HFSQL pouvant être utilisées en Accès distant

Les fonctions HFSQL peuvent être utilisées lors d'un accès à une base de données par Accès Distant.

Les fonctions non disponibles en Accès distant sont les suivantes :

Versions 10 et supérieures
HDateEnreg
Nouveauté 10
HDateEnreg
HDateEnreg
Renvoie la date et l'heure de la dernière écriture d'un enregistrement dans un fichier HFSQL (Classic ou Client/Serveur).
Versions 09 et supérieures
HDéclareExterne
Nouveauté 09
HDéclareExterne
HDéclareExterne
Importe temporairement dans l'analyse en cours, la description d'un fichier à partir d'un fichier HFSQL existant.
Versions 09 et supérieures
HDBCréation
Nouveauté 09
HDBCréation
HDBCréation
Termine la description de la structure du fichier de données xBase par programmation.
Versions 09 et supérieures
HDBDécritFichier
Nouveauté 09
HDBDécritFichier
HDBDécritFichier
Décrit par programmation un fichier au format dBase 3 (format le plus répandu).
Versions 09 et supérieures
HDBDécritIndex
Nouveauté 09
HDBDécritIndex
HDBDécritIndex
Décrit par programmation les différents fichiers d'index qui seront créés.
Versions 09 et supérieures
HDBDécritRubrique
Nouveauté 09
HDBDécritRubrique
HDBDécritRubrique
Décrit par programmation chaque rubrique de la structure d'un fichier xBase décrit avec HDBDécritFichier.
Versions 09 et supérieures
HDBIndex
Nouveauté 09
HDBIndex
HDBIndex
Ouvre un fichier d'index xBase.
Versions 09 et supérieures
HDBOuvre
Nouveauté 09
HDBOuvre
HDBOuvre
Ouvre le fichier de données xBase et le fichier "mémo" s'il existe.
Versions 09 et supérieures
HDBOuvreSansBloquer
Nouveauté 09
HDBOuvreSansBloquer
HDBOuvreSansBloquer
En mode mono-utilisateur, ouvre un fichier de données xBase sans le bloquer.
Versions 09 et supérieures
HDBTypeTri
Nouveauté 09
HDBTypeTri
HDBTypeTri
Renvoie ou modifie la relation d'ordre des rubriques textes des fichiers xBase.
Versions 09 et supérieures
HDétruitVue
Nouveauté 09
HDétruitVue
HDétruitVue
Détruit une vue précédemment créée.
Versions 09 et supérieures
HFinInterditModif
Nouveauté 09
HFinInterditModif
HFinInterditModif
Débloque un fichier qui a été bloqué par le même programme avec la fonction HInterditModif.
Versions 09 et supérieures
HGèreJournal
Nouveauté 09
HGèreJournal
HGèreJournal
Active ou désactive la gestion du journal d'un fichier journalé.
Versions 09 et supérieures
HGèreRéplication
Nouveauté 09
HGèreRéplication
HGèreRéplication
Débranche (ou re-branche) temporairement la réplication.
Versions 09 et supérieures
HInfoRéplica
Nouveauté 09
HInfoRéplica
HInfoRéplica
Renvoie des informations sur le réplica spécifié.
Versions 09 et supérieures
HInitAbonné
Nouveauté 09
HInitAbonné
HInitAbonné
Initialise la plage d'identifiants automatiques d'un fichier de description d'un réplica abonné (extension ".RPL").
Versions 09 et supérieures
HInterditModif
Nouveauté 09
HInterditModif
HInterditModif
Interdit toute modification sur un fichier de données (pour tous les programmes, y compris le programme qui a demandé l'interdiction).
Versions 09 et supérieures
HJournalInfo
Nouveauté 09
HJournalInfo
HJournalInfo
Ajoute des commentaires dans le journal lors de l'enregistrement de l'opération journalée.
Versions 09 et supérieures
HJournalRecrée
Nouveauté 09
HJournalRecrée
HJournalRecrée
Permet de re-créer un journal à vide.
Versions 09 et supérieures
HJournalRedémarre
Nouveauté 09
HJournalRedémarre
HJournalRedémarre
Redémarre la journalisation du fichier.
Versions 09 et supérieures
HJournalStop
Nouveauté 09
HJournalStop
HJournalStop
Arrête la journalisation du fichier.
Versions 09 et supérieures
HOuvreConnexion
Nouveauté 09
HOuvreConnexion
HOuvreConnexion
Ouvre une connexion à une base de données spécifique.
Versions 09 et supérieures
HPoste
Nouveauté 09
HPoste
HPoste
Mémorise un numéro ou un identifiant unique de poste afin d'utiliser le journal et les transactions en réseau.
Versions 09 et supérieures
HPrépareRequêteSQL
HPrépareRequêteSQL
Initialise une requête écrite en langage SQL et déclare cette requête au serveur de base de données pour optimiser les prochaines exécutions de cette requête.
Versions 09 et supérieures
HRégénèreFichier
Nouveauté 09
HRégénèreFichier
HRégénèreFichier
Régénère un fichier de données à partir de son journal.
Versions 09 et supérieures
HRéindexationEnCours
HRéindexationEnCours
Avertit si une ré-indexation est en cours sur un fichier de données HFSQL et renvoie le pourcentage de ré-indexation effectué.
Versions 09 et supérieures
HRplDéclareLiaison
Nouveauté 09
HRplDéclareLiaison
HRplDéclareLiaison
Déclare une liaison de type (1,1) (0,n) entre deux tables.
Versions 09 et supérieures
HRplProcédureFiltre
HRplProcédureFiltre
Définit la procédure WLangage qui sera appelée à chaque opération de réplication pour un fichier donné.
Versions 09 et supérieures
HStatDate
Nouveauté 09
HStatDate
HStatDate
Renvoie la date de la dernière mise à jour des statistiques d'index.
Versions 09 et supérieures
HStatHeure
Nouveauté 09
HStatHeure
HStatHeure
Renvoie l'heure de la dernière mise à jour des statistiques d'index.
Versions 09 et supérieures
HSubstRep
Nouveauté 09
HSubstRep
HSubstRep
Associe le répertoire des données spécifié dans l'analyse à un répertoire présent sur le disque.
Versions 09 et supérieures
HSynchroniseRéplica
HSynchroniseRéplica
Synchronise le réplica maître et le réplica abonné : les opérations effectuées sur un des réplicas sont transférées dans l'autre réplica.
Versions 09 et supérieures
HVérifieStructure
Nouveauté 09
HVérifieStructure
HVérifieStructure
Fixe le mode de comparaison des fichiers de données.

Attention :
  • Lors de l'utilisation de la fonction HExécuteRequête, la constante hAvecFiltre n'est pas gérée.
  • La réplication, la journalisation, les langages externes, les vignettes ne sont pas gérées.
  • HFSQL Client/Serveur n'est pas disponible.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.

Optimisations
L'utilisation des champs tels que les champs Table ou les champs Combo basés sur un fichier de donnés est déconseillée. Il est préférable de créer une requête permettant d'alimenter le contenu du champ Table ou Combo.

De plus, les données affichées doivent être réduites au strict minimum. Par exemple, il est préférable d'ajouter des critères de recherche plutôt que d'afficher une liste complète de clients.

De façon générale, le nombre "d'aller-retour" entre le poste serveur et le poste client doit être limité au maximum. Il peut ainsi être préférable de stocker de façon temporaire des données sur le poste Client que de les demander au serveur (données de configuration, liste des utilisateurs, ...).

Pour plus de détails, consultez Optimisation de l'accès distant.

Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire