PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Ouvrir une analyse distante depuis une application associée ou non à une analyse
  • Ouverture d'une analyse déjà ouverte
  • Fermeture de la connexion
  • Contexte HFSQL
  • Utilisateur par défaut
  • Version des analyses ouvertes avec HConnecteAccèsDistant
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
HConnecteAccèsDistant (Fonction)
En anglais : HConnectRemoteAccess
ODBCNon disponible avec ce type de connexion
Ouvre une analyse au format HFSQL Classic via un accès distant (cette fonction est équivalente à la seconde syntaxe de la fonction HOuvreAnalyse). Il est ainsi possible d'accéder aux fichiers de données décrits dans cette analyse, et à la structure de ces fichiers de données. Une configuration spécifique du poste serveur et du poste client sont nécessaires. Pour plus de détails, consultez Accès distant avec HFSQL.
La fonction HConnecteAccèsDistant permet de manipuler des fichiers de données via Internet : cette manipulation est transparente pour l'utilisateur.
Attention : Lors de l'ouverture d'une analyse "distante", certaines fonctions HFSQL ne sont plus exécutées localement : ces fonctions sont transmises à la DLL de gestion des fonctions HFSQL distante, via le module d'accès distant de wdxxxcom.dll. Le seul changement, du point de vue de la programmation pour une application utilisant l'accès distant, est effectué au niveau de l'ouverture de l'analyse.
Remarque : Afin de réaliser l'ouverture d'une analyse distante, une configuration spécifique du poste serveur et du poste client sont nécessaires. Pour plus de détails, consultez Accès distant avec HFSQL.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Ouverture de l'analyse GESTCOM via un accès distant
SI HConnecteAccèsDistant("192.168.1.1", "User", "MotPasseUser", ...
"C:\GESTCOM\GESTCOM.WDD", "MotPasseGestcom") = Faux ALORS
Erreur("Impossible d'ouvrir l'analyse sur le serveur." + RC + ...
"Erreur rencontrée : " + HErreurInfo())
FIN
Syntaxe
<Résultat> = HConnecteAccèsDistant(<Adresse du serveur> [, <Nom de l'utilisateur> [, <Mot de passe utilisateur> [, <Chemin du .WDD> [, <Mot de passe>]]]])
<Résultat> : Booléen
  • Vrai si l'analyse a été ouverte,
  • Faux dans le cas contraire. La fonction HErreurInfo permet d'obtenir plus d'informations sur le problème rencontré (voir les Notes).
<Adresse du serveur> : Chaîne de caractères (avec guillemets)
Adresse IP ou nom DNS du serveur.
Rappel : Une adresse IP est une chaîne de caractères qui contient l'adresse "Internet Protocole" de la machine au format xxx.xxx.xxx.xxx.
<Nom de l'utilisateur> : Chaîne de caractères optionnelle (avec guillemets)
Nom de l'utilisateur (permet d'accéder aux données).
Si ce paramètre n'est pas spécifié, le nom de l'utilisateur par défaut sera utilisé (ANONYME).
<Mot de passe utilisateur> : Chaîne de caractères optionnelle (avec guillemets)
Mot de passe utilisateur (associé au nom de l'utilisateur).
Si ce paramètre n'est pas spécifié, le mot de passe de l'utilisateur par défaut sera utilisé (HYPERFILE).
<Chemin du .WDD> : Chaîne de caractères optionnelle (avec guillemets)
Chemin complet du fichier ".WDD" de l'analyse. Ce fichier contient la description de l'analyse à ouvrir.
Si seuls le lecteur et le nom de l'analyse sont spécifiés : l'analyse est recherchée dans le répertoire en cours du lecteur spécifié.
Si ni le lecteur, ni le chemin de l'analyse ne sont spécifiés, l'analyse est recherchée dans le répertoire en cours du disque en cours.
Si ce paramètre n'est pas spécifié, l'analyse associée à l'application en cours sera ouverte.
<Mot de passe> : Chaîne de caractères optionnelle (avec guillemets)
Mot de passe de l'analyse, défini dans l'éditeur d'analyses.
Remarques

Ouvrir une analyse distante depuis une application associée ou non à une analyse

Le tableau ci-dessous présente les différents cas d'utilisation de la fonction HConnecteAccèsDistant :
Application associée à une analyseApplication non associée à une analyse
Ouverture de l'analyse en local (sur le serveur de déploiement)Ouverture automatique au lancement de l'applicationOuverture grâce à la fonction HOuvreAnalyse (en spécifiant l'analyse à ouvrir)
Ouverture de l'analyse sur un autre serveurOuverture grâce à la fonction HConnecteAccèsDistant (il n'est pas nécessaire de spécifier le chemin et le nom de l'analyse à ouvrir)Ouverture grâce à la fonction HConnecteAccèsDistant (en spécifiant l'analyse à ouvrir)
Résultat de la fonction HConnecteAccèsDistantFaux :
  • si l'analyse associée à l'application n'existe pas sur le serveur.
  • si l'analyse spécifiée n'existe pas sur le serveur.
Dans tous les cas, l'application continue de travailler avec l'analyse en cours.
Faux, si l'analyse spécifiée n'existe pas sur le serveur.
Le prochain accès à la base de données générera une erreur du WLangage.
Vrai :
  • si l'analyse associée à l'application existe sur le serveur et est valide.
  • si l'analyse spécifiée existe sur le serveur et est valide.
Dans tous les cas, l'analyse s'ouvre sur le serveur.
Vrai, si l'analyse spécifiée existe sur le serveur et est valide.
L'analyse s'ouvre sur le serveur.
Remarque : L'analyse ouverte avec la fonction HConnecteAccèsDistant est recherchée :
  • tout d'abord, dans la bibliothèque principale de l'application selon son nom physique complet.
  • puis, sur le disque en cours.

Ouverture d'une analyse déjà ouverte

Si la fonction HConnecteAccèsDistant ouvre une analyse déjà ouverte sur le serveur, la fonction HConnecteAccèsDistant n'a aucun effet.

Fermeture de la connexion

Pour fermer la connexion à l'accès distant, utilisez la fonction HFermeAnalyse.
Pour débranchez temporairement l'accès distant, utilisez la fonction HGèreAccèsDistant.

Contexte HFSQL

Attention : Lors de l'utilisation de la fonction HConnecteAccèsDistant, le contexte HFSQL en cours est automatiquement ré-initialisé. Les opérations suivantes sont automatiquement effectuées :
  • Fermeture de l'analyse en cours.
  • Tous les fichiers de données précédemment ouverts sont fermés.
  • Toutes les vues HFSQL existantes sont supprimées.
  • Toutes les requêtes existantes sont supprimées.
  • Toutes les déclarations réalisées avec les fonctions HDéclareExterne et HDécritFichier sont supprimées.

Utilisateur par défaut

L'utilisateur par défaut (nom : ANONYME, et mot de passe : HYPERFILE) est supporté uniquement avec le serveur d'accès distant livré avec WINDEV (WDServeurAccesDistant).
Si un autre serveur d'accès distant est utilisé, il est nécessaire d'ajouter un utilisateur par défaut dans le fichier WdRpcSrv.ini. Ce fichier contient les droits de connexion des utilisateurs. Ce fichier est un fichier texte qui se trouve dans le même répertoire que le serveur RPC. Il doit contenir une section "passwords" dans laquelle chaque point d'entrée est un nom d'utilisateur.
Pour plus de détails, consultez Accès distant avec HFSQL.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsAjaxCode Utilisateur (MCU)Hyper File 5.5

Version des analyses ouvertes avec HConnecteAccèsDistant

La fonction HConnecteAccèsDistant ne permet pas d'ouvrir les analyses au format WINDEV 5.5 ou WEBDEV 1.5 et inférieur. Seules les analyses WINDEV/WEBDEV 9 et supérieures peuvent être ouvertes.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire