PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Installation
  • Configuration
  • Utilisation de l'analyse dans une connexion à une base de données HFSQL Classic
  • Remarques
  • Exemples de chaînes de connexion OLE DB
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
Présentation
Le provider OLE DB pour HFSQL permet d'accéder à une base de données HFSQL (Classic ou Client/Serveur) depuis un logiciel externe gérant les accès par OLE DB.
Le provider est disponible en lecture et en écriture. Une application écrite dans un langage tiers peut lire et écrire dans des fichiers HFSQL.
Pour plus d'informations, consultez un manuel spécialisé sur OLE DB.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Installation
Le provider OLE DB pour HFSQL est fourni sous la forme d'un pack d'installation disponible dans le répertoire "Install\OLEDB" de WINDEV et WEBDEV.
Par défaut, le provider OLE DB est installé dans le répertoire "C:\Program Files\Fichiers communs\PC SOFT\23.0\OLEDB".
Remarque : Pour qu'une application puisse utiliser un provider OLE DB, il est nécessaire d'installer le composant MDAC (Microsoft Data Access Component) en version 2.8 ou supérieure. Ce composant est disponible en téléchargement sur le site de Microsoft. Il est intégré au système d'exploitation à partir de Windows 2003 Serveur et Windows Vista.
Configuration
L'application utilisant un provider OLEDB doit fournir une chaîne de connexion. Cette chaîne définit le provider à utiliser ainsi que les paramètres de connexion à fournir à ce provider pour établir la connexion avec la base de données.
Cette chaîne (appelée chaîne de connexion) peut être :
  • saisie en programmation (par exemple dans une application C# ou VB.Net).
  • construite à l'aide d'un assistant (par exemple avec l'outil Crystal Report).
Le format général de la chaîne de connexion est le suivant :
<Element1>=<Valeur1>;<Element2>=<Valeur2>;...;<ElementN>=<ValeurN>
Les différents éléments de la chaîne de connexion sont les suivants :
ElémentValeur lors d'une connexion à une base HFSQL Client/ServeurValeur lors d'une connexion à une base HFSQL Classic
ProviderCet élément vaut toujours "PCSOFT.HFSQL"
Data SourceNom (ou adresse IP) du serveur HFSQL et port de connexion.
Le port peut ne pas être spécifié si le serveur utilise le port par défaut (4900).
Le nom et le numéro de port doivent être séparés par ":" (deux points).

Exemple : monserveur.masociete.fr:4910
Chemin complet de l'analyse (fichier .WDD) de la base.
Ce paramètre est optionnel.
Initial CatalogNom de la base de données.Chemin complet du répertoire contenant les fichiers de données.
User IDNom d'utilisateur pour se connecter au serveur HFSQL.Ce paramètre est ignoré.
PasswordMot de passe pour se connecter au serveur HFSQL.Ce paramètre est ignoré.
Extended PropertiesChaîne de caractères contenant les différentes propriétés spécifiques au provider OLE DB pour HFSQL.
Cette chaîne est de la forme :
<Propriété1>=<Valeur1>;<Propriété2>=<Valeur2>;...;<PropriétéN>=<ValeurN>

Les caractères \ (antislash), = (signe égal), ; (point virgule) ou : (deux points) employés dans cette chaîne doivent être précédés du caractère \ (antislash).
Les propriétés disponibles pour l'élément "Extended Properties" de la chaîne de connexion OLE DB sont :
PropriétéValeur
PasswordMot de passe des fichiers de données HFSQL sous la forme :
<NomFichier>:<MotDePasse>
Remarques :
  • <NomFichier> représente le nom logique du fichier de données.
  • <NomFichier> peut être remplacé par le caractère "*" (étoile) pour indiquer que le mot de passe s'applique à tous les fichiers de données.
  • Cette propriété peut être répétée pour indiquer les mots de passe de plusieurs fichiers de données.
    Exemple : Password=MonFichier1:MotDePasse1;Password=MonFichier2:MotDePasse2
LanguageLangue utilisée pour le traitement des chaînes (tri, ...) par le provider OLE DB pour HFSQL.
Les valeurs correspondent aux constantes de la fonction ChangeAlphabet du WLangage.
Les valeurs disponibles sont :
Valeur de la propriétéConstante WLangage correspondante
UTF-8alphabetUTF8
ISO-8859-1 ou ISO-LATIN-1alphabetOccidental
ISO-8859-2 ou ISO-LATIN-2alphabetEuropeEst
ISO-8859-3alphabetTurc
ISO-8859-4alphabetBalte
ISO-8859-5 ou KOI8-RalphabetRusse
ISO-8859-6alphabetArabe
ISO-8859-7alphabetGrec
ISO-8859-8alphabetHébreu
ISO-2022-JPalphabetJaponais
GB-2312alphabetChinois
VISCIIalphabetVietnamien
BIG5alphabetChinoisTraditionnel
ISO-2022-KRalphabetCoréen
ISO-8859-11alphabetThaï

Utilisation de l'analyse dans une connexion à une base de données HFSQL Classic

Dans le cas d'une connexion à une base de données HFSQL Classic :
  • Si le chemin du fichier WDD est indiqué dans le paramètre "Data Source" de la chaîne de connexion :
    • Seuls les fichiers décrits dans cette analyse seront pris en compte par la connexion.
    • Les liaisons et les règles d'intégrité décrites dans l'analyse sont prises en compte automatiquement.
  • Si le chemin du fichier WDD n'est pas indiqué dans le paramètre "Data Source" de la chaîne de connexion :
    • Tous les fichiers présents dans le répertoire indiqué dans le paramètre "Initial Catalog" seront pris en compte.
    • Aucune contrainte d'intégrité entre les fichiers n'est respectée automatiquement.

Remarques

  • Lors d'un accès par le provider OLE DB pour HFSQL, les fenêtres d'assistance automatique de HFSQL sont désactivées.
  • Les rubriques de type "Durée" dans les fichiers de données HFSQL sont retournées sous forme d'entiers sur 8 octets par le provider OLE DB. L'unité est la milliseconde.
  • Les rubriques de types tableau ne sont pas gérées par le provider OLE DB.
  • Dans cette version, les commandes SQL avec paramètres ne sont pas gérées.
    Versions 17 et supérieures
    Les requêtes paramétrées sont gérées. Il est ainsi possible d'ajouter des mémos HFSQL (mémo binaire par exemple).
    Nouveauté 17
    Les requêtes paramétrées sont gérées. Il est ainsi possible d'ajouter des mémos HFSQL (mémo binaire par exemple).
    Les requêtes paramétrées sont gérées. Il est ainsi possible d'ajouter des mémos HFSQL (mémo binaire par exemple).

Exemples de chaînes de connexion OLE DB

  • Connexion à une base HFSQL Classic sans préciser l'analyse :
    Provider=PCSOFT.HFSQL;Initial Catalog=c:\Ma Base HFSQL
  • Connexion à une base HFSQL Classic en précisant l'analyse :
    Provider=PCSOFT.HFSQL;Data Source=c:\Ma Base HFSQL\MonAnalyse.wdd;
    Initial Catalog=c:\Ma Base HFSQL
  • Connexion à une base HFSQL Client/Serveur :
    Provider=PCSOFT.HFSQL;Data Source=serveurbdd.masociete.fr:4910;
    User ID=admin;Password=secret;Initial Catalog=MaBase
  • Connexion à une base HFSQL Client/Serveur avec des fichiers protégés par des mots de passe et utilisant l'alphabet russe :
    Provider=PCSOFT.HFSQL;Data Source=serveurbdd.masociete.fr;
    User ID=utilisateur;Initial Catalog=MaBaseRusse;
    Extended Properties="Password=*:secret1;
    Password=Fichier2:secret2;Language=KOI8-R"

    Remarque : Dans cet exemple, tous les fichiers de la base de données sont protégés par le mot de passe "secret1" sauf le fichier "Fichier2" qui est protégé par le mot de passe "secret2".
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire