|
|
|
|
|
|
|
|
- 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 la fonction HConnecteAccèsDistant
HConnecteAccèsDistant (Fonction) En anglais : HConnectRemoteAccess
 Non 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.
// 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(<Serveur> [, <Utilisateur> [, <Mot de passe utilisateur> [, <Chemin du .WDD> [, <Mot de passe analyse>]]]])
<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).
<Serveur> : Chaîne de caractères 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. <Utilisateur> : Chaîne de caractères optionnelle 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 Mot de passe 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 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 analyse> : Chaîne de caractères optionnelle 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 analyse | Application non associée à une analyse |
|---|
| Ouverture de l'analyse en local (sur le serveur de déploiement) | Ouverture automatique au lancement de l'application | Ouverture grâce à la fonction HOuvreAnalyse (en spécifiant l'analyse à ouvrir) | | Ouverture de l'analyse sur un autre serveur | Ouverture 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èsDistant | Faux :- 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, cette fonction n'a aucun effet. Fermeture de la connexion Pour fermer la connexion à l'accès distant, utilisez la fonction HFermeAnalyse. 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.
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 (WDServeurRPC). 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. Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|