PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

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
HDéclareExterne (Fonction)
En anglais : HDeclareExternal
ODBCNon disponible avec ce type de connexion
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 HAnnuleDéclaration.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Versions 19 et supérieures
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 19
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
AndroidWidget AndroidJava Cette fonction est disponible uniquement pour les fichiers de données HFSQL Classic ou Client/Serveur.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAjaxCode Utilisateur (MCU)
// Déclaration d'un fichier FournisseurWD à partir du chemin complet
// du fichier HFSQL Classic (extension .FIC comprise)
HDéclareExterne("C:\GestCom\Fournisseur.fic", "FournisseurWD")
SI ErreurDétectée = Vrai ALORS
// Erreur de déclaration du fichier, on affiche l'erreur
Erreur(HErreurInfo())
FIN
Syntaxe
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)HFSQL

Utilisation avec des fichiers HFSQL Classic (monoposte ou réseau) Masquer les détails

<Résultat> = HDéclareExterne(<Chemin complet du fichier> , <Nom alias> [, <Mot de passe>])
<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.
<Chemin complet du fichier> : Chaîne de caractères (avec guillemets)
Chemin complet d'accès au fichier de données HFSQL dont la description doit être importée (260 caractères maximum). Ce nom doit contenir le chemin et l'extension du fichier de données.
Si la fonction HDéclareExterne est utilisée dans une procédure stockée, le chemin du fichier de données doit être relatif à la base de données en cours.
<Nom alias> : Chaîne de caractères (avec guillemets)
Nom logique du fichier de données. Ce nom permettra de manipuler le fichier de données. Ce nom peut également correspondre à une variable de type Source de données.
<Mot de passe> : Chaîne de caractères optionnelle (avec ou sans guillemets)
  • Mot de passe associé au fichier de données.
  • Chaîne vide ("") si aucun mot de passe n'est utilisé.
Si le mot de passe est précisé, il est conservé : il n'est pas nécessaire d'indiquer à nouveau ce mot de passe dans les prochaines fonctions de manipulation du fichier de données.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesAndroidWidget AndroidiPhone/iPadWindows MobileJavaAjaxCode Utilisateur (MCU)HFSQL Client/ServeurOLE DBAccès Natifs

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

<Résultat> = HDéclareExterne(<Nom du fichier> , <Nom alias> , <Nom de la 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.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
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 hPasse avant d'utiliser la fonction HDéclareExterne.
<Nom alias> : Chaîne de caractères (avec guillemets)
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.
<Nom de la connexion> : Chaîne de caractères (avec guillemets)
Nom de la 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.
WINDEVWEBDEV - Code ServeurWINDEV MobileEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)OLE DBAccès Natifs

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

<Résultat> = HDéclareExterne(<Nom du fichier> , <Nom alias> , <Nom de l'utilisateur> [, <Mot de passe> [, <Source de données> [, <Provider OLE DB ou Accès 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.
<Nom du fichier> : Chaîne de caractères (avec guillemets)
Nom du fichier de données dans la base externe.
<Nom alias> : Chaîne de caractères (avec guillemets)
Nom logique du fichier de données. Ce nom permettra de manipuler le fichier de données dans l'application en cours.
<Nom de l'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 Accès Natif> : Chaîne de caractères optionnelle
Nom du provider OLE DB à utiliser ou une des constantes suivantes :
hAccèsNatifAS400Accès Natif AS/400 (module optionnel)
hAccèsNatifDB2Accès Natif DB2 (module optionnel)
hAccèsNatifInformixAccès Natif informix (module optionnel)
Versions 20 et supérieures
hAccèsNatifMariaDB
Nouveauté 20
hAccèsNatifMariaDB
hAccèsNatifMariaDB
Accès Natif MariaDB (module optionnel de WINDEV/WEBDEV)
hAccèsNatifMySQLAccès Natif MySQL (module optionnel)
hAccèsNatifOracleAccès Natif Oracle (module optionnel)
hAccèsNatifPostgreSQLAccès Natif PostgreSQL (module optionnel de WINDEV/WEBDEV)
hAccèsNatifProgressAccès Natif Progress (module optionnel)
Versions 16 et supérieures
hAccèsNatifSQLAzure
Nouveauté 16
hAccèsNatifSQLAzure
hAccèsNatifSQLAzure
Accès Natif SQL Azure (module optionnel, fourni avec l'Accès Natif SQL Server)
Versions 15 et supérieures
hAccèsNatifSQLite
Nouveauté 15
hAccèsNatifSQLite
hAccèsNatifSQLite
Accès Natif SQLite
hAccèsNatifSQLServerAccès Natif SQL Server (module optionnel)
hAccèsNatifSybaseAccès Natif Sybase (module optionnel)
hAccèsNatifXBaseAccès Natif xBase
hAccèsNatifXMLAccès 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
Versions 19 et supérieures
hOledbAccess2010
Nouveauté 19
hOledbAccess2010
hOledbAccess2010
Provider 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.
Windows Mobile Les constantes disponibles sont les suivantes :
hAccèsNatifOracleAccès Natif Oracle Lite (module optionnel)
hAccèsNatifSQLServerAccès Natif SQL Server CE (module optionnel)
<Accès> : Constante optionnelle
Paramètre le type d'accès au fichier de données.
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.
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.
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.
  • La seconde syntaxe de cette fonction ne peut pas être utilisée lors d'un accès à une base de données via Accès distant.
  • Pour utiliser la fonction HDé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.
Liste des exemples associés :
WD Fichier externe Exemples didactiques (WINDEV) : WD Fichier externe
[ + ] Ce programme réalisé avec WINDEV montre comment manipuler des fichiers non décrits dans l'analyse.
Il est possible d'utiliser les fonctions du WLangage HDéclare ou HDéclareExterne.
Les différences de comportement de ces 2 modes de déclaration du fichier sont mises en évidence dans cet exemple.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220hf.dll
Windows Mobile wp220hf.dll
Java wd220java.jar
Linux wd220hf.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire