DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / 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
Importe temporairement dans l'analyse en cours la description d'un fichier de données à partir d'un fichier de données HFSQL existant. Ce fichier de données est ouvert. Pour ne plus utiliser cette description de fichier de données, utilisez la fonction <Source>.AnnuleDéclaration.
Syntaxe
AndroidWidget AndroidiPhone/iPadHFSQL Client/ServeurConnecteurs Natifs (Accès Natifs)

Utilisation avec un accès OLE DB, un Connecteur Natif, HFSQL Client/Serveur et une connexion existante Masquer les détails

<Résultat> = <Source>.DéclareExterne(<Alias> , <Connexion>)
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données dans la base externe.
HFSQL Client/Serveur Ce paramètre correspond au nom physique du fichier de données, relatif à la base de données (extension comprise). Exemple : "monfichier.fic" (ou si la base a des sous-répertoires : ".\repertoire\monfichier.fic").
Si le fichier de données possède un mot de passe, il est nécessaire de préciser ce mot de passe avec la fonction <Source>.MotDePasse avant d'utiliser la fonction <Source>.DéclareExterne.
<Alias> : Chaîne de caractères
Nom logique du fichier de données. Ce nom permettra de manipuler le fichier de données dans l'application en cours. Ce nom peut également correspondre à une variable de type Source de données.
<Connexion> : Chaîne de caractères
Connexion à une base de données. Cette connexion a été définie dans l'éditeur d'analyses ou décrite par programmation grâce à la fonction HDécritConnexion.
Android Seules les connexions à une base de données HFSQL Client/Serveur sont disponibles.
Connecteurs Natifs (Accès Natifs)

Utilisation avec un accès OLE DB ou un Connecteur Natif Masquer les détails

<Résultat> = <Source>.DéclareExterne(<Alias> , <Utilisateur> [, <Mot de passe> [, <Source de données> [, <Provider OLE DB ou Connecteur Natif> [, <Accès>]]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données dans la base externe.
<Alias> : Chaîne de caractères
Nom logique du fichier de données. Ce nom permettra de manipuler le fichier de données dans l'application en cours.
<Utilisateur> : Chaîne de caractères
Nom de l'utilisateur de la source de données.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe du fichier de données à ouvrir (si ce mot de passe existe).
<Source de données> : Chaîne de caractères optionnelle
Chemin complet de la source de données.
<Provider OLE DB ou Connecteur Natif> : Chaîne de caractères optionnelle
Nom du provider OLE DB à utiliser ou une des constantes suivantes :
hAccèsNatifAS400Connecteur Natif AS/400 (module optionnel)
hAccèsNatifDB2Connecteur Natif DB2 (module optionnel)
hAccèsNatifInformixConnecteur Natif informix (module optionnel)
hAccèsNatifMariaDBConnecteur Natif MariaDB (module optionnel de WINDEV/WEBDEV)
hAccèsNatifMySQLConnecteur Natif MySQL (module optionnel)
hAccèsNatifOracleConnecteur Natif Oracle (module optionnel)
hAccèsNatifPostgreSQLConnecteur Natif PostgreSQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifProgressConnecteur Natif Progress (module optionnel)
hAccèsNatifSQLAzureConnecteur Natif SQL Azure (module optionnel, fourni avec le Connecteur Natif SQL Server)
hAccèsNatifSQLiteConnecteur Natif SQLite
hAccèsNatifSQLServerConnecteur Natif SQL Server (module optionnel)
hAccèsNatifSybaseConnecteur Natif Sybase (module optionnel)
hAccèsNatifXBaseConnecteur Natif xBase
hAccèsNatifXMLConnecteur Natif XML
hODBCProvider OLE DB pour ODBC. Permet d'accéder à une source de données ODBC déclarée dans les sources de données ODBC de Windows
hOledbAccess97Provider OLE DB pour Access 97
hOledbAccess2000Provider OLE DB pour Access 2000
hOledbAccess2007Provider OLE DB pour Access 2007
hOledbAccess2010Provider OLE DB pour Access 2010
hOledbDBase5Provider OLE DB pour DBase 5
hOledbExcel2000Provider OLE DB pour Excel 2000
hOledbExcel2007Provider OLE DB pour Excel 2007
hOledbExcel97Provider OLE DB pour Excel 97
hOledbLotus4Provider OLE DB pour Lotus 4
hOledbOracleProvider OLE DB pour Oracle
hOledbSQLServerProvider OLE DB pour SQL Server
Attention : Pour utiliser une connexion OLE DB il est nécessaire :
  • d'installer le MDAC version 2.6 minimum (installation réalisée avec WINDEV/WEBDEV et lors de la création de la version Client)
  • d'installer le provider OLE DB correspondant à la base de données manipulée.
<Accès> : Constante optionnelle
Paramètre le type d'accès au fichier de données.
hOLectureLe fichier de données est accessible uniquement en lecture. Seule la lecture des enregistrements est possible. Il n'est pas possible d'en ajouter ou d'en supprimer.
hOLectureEcriture
(valeur par défaut)
Le fichier de données est accessible en lecture et en écriture. Il est possible aussi bien de lire des enregistrements que d'écrire de nouveaux enregistrements.
Remarques
  • Toutes les fonctions HFSQL peuvent être utilisées sur le fichier de données importé, à l'exception de la gestion de l'intégrité.
  • Le nombre d'importations de descriptions est illimité.
  • Cette fonction peut être utilisée avec des fichiers de données au format XML.
  • Pour utiliser la fonction <Source>.DéclareExterne dans une procédure stockée :
    • il faut donner le chemin relatif du fichier de données par rapport au répertoire de la base contenant la procédure stockée. Le chemin devra indiquer le nom et l'extension du fichier de données.
    • il ne faut pas utiliser de connexion : c'est la base en cours sur laquelle se trouve la procédure stockée qui sera utilisée.
  • Par défaut, si le projet en cours :
    • est associé à une analyse, le mode de blocage effectué sur les fichiers de données est multi-utilisateurs (les fichiers ne sont pas bloqués à leur ouverture, les autres applications peuvent accéder aux fichiers).
    • n'est pas associé à une analyse, le mode de blocage effectué sur les fichiers de données est mono-utilisateurs : les fichiers sont totalement bloqués en lecture et en écriture dès leur ouverture. Ce mode empêche tout autre application d'accéder aux fichiers déjà ouverts par l'application en cours.
Composante : wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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