DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Quand utiliser la fonction HPasse ?
  • Définir un mot de passe sur un fichier de données
  • Supprimer un mot de passe sur un fichier de données
  • Gestion du mot de passe (OLE DB et Connecteurs Natifs)
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
Fixe le mot de passe utilisé pour créer ou pour ouvrir un fichier de données. Le mot de passe est stocké et sera utilisé lors de l'ouverture ou de la création du fichier de données, si aucun mot de passe n'est spécifié.
Remarques :
  • Attention : Il est nécessaire de définir un mot de passe pour réaliser un cryptage des données. Le cryptage des données doit être configuré lors de la description du fichier de données dans l'éditeur d'analyses (Onglet "Détail").
  • Ce mot de passe peut aussi être spécifié directement dans les fonctions de création (HCréation, HCréationSiInexistant) et d'ouverture du fichier de données (HOuvre).
  • Fichiers cryptés dans une connexion HFSQL :  Attention : L'ordre d'utilisation des fonctions permettant de se connecter à une base de données HFSQL Client/Serveur est important. Consultez Optimiser les temps de connexion aux bases HFSQL Client/Serveur pour plus de détails.
Exemple
// Ouverture d'un fichier de données avec mot de passe et contrôle d'erreur
HPasse(CLIENT, "MotDePasse")
SI HCréationSiInexistant(CLIENT) = Faux ALORS
	Erreur("Erreur HFSQL : " + HErreurInfo())
	RETOUR
FIN
// HErreurMotDePasse permet de savoir si l'erreur rencontrée est une erreur de mot de passe
SI HCréationSiInexistant() = Faux ALORS
	// Détail de l'erreur
	SI HErreurMotDePasse() = Vrai ALORS
		Erreur("Mot de passe invalide")
		// Code pour réessayer
	FIN
FIN
Syntaxe
<Résultat> = HPasse(<Fichier de données> [, <Mot de passe>])
<Résultat> : Booléen
  • Vrai si le mot de passe est enregistré,
  • Faux en cas d'erreur (mémoire insuffisante par exemple). Les fonctions HErreur et HErreurInfo permettent d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données utilisant un mot de passe.
Si ce paramètre correspond à "*", le mot de passe sera utilisé pour tous les fichiers de données décrits dans l'analyse.
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse (non disponible en Android et Android Widget). Dans ce cas, le mot de passe sera utilisé pour tous les fichiers du groupe.
Si le fichier de données est déclaré avec la fonction HDéclareExterne, <Nom du fichier> correspond au nom de l'alias du fichier de données.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe associé au fichier de données.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), aucun mot de passe n'est défini pour le fichier de données. La taille du mot de passe n'est pas limitée.
HFSQL ClassicHFSQL Client/Serveur Le mot de passe des fichiers HFSQL est insensible à la casse.
Remarques

Quand utiliser la fonction HPasse ?

La fonction HPasse doit être appelée :
  • avant les fonctions d'ouverture ou de création explicites : HOuvre, HCréation, HCréationSiInexistant.
  • avant les fonctions HFSQL accédant aux fichiers de données et qui ouvrent automatiquement les fichiers de données si ce n'est pas déjà fait (lecture, recherche, ajout, ...).
Remarques :
  • Si un mot de passe est précisé dans les fonctions d'ouverture ou de création explicites (fonctions HOuvre, HCréation, HCréationSiInexistant), le mot de passe précisé dans la fonction HPasse n'est pas pris en compte.
  • Le mot de passe des fichiers HFSQL est insensible à la casse.
  • Pour changer un mot de passe sur un fichier de données existant ou ajouter un mot de passe sur un fichier de données créé sans mot de passe, il faut utiliser la fonction HChangeMotDePasse.

Définir un mot de passe sur un fichier de données

Un fichier de données sera protégé par mot de passe uniquement si :
  • soit la fonction HPasse a été utilisée avant la fonction de création du fichier de données (fonctions HCréation et HCréationSiInexistant),
  • soit le mot de passe a été précisé directement dans la fonction de création du fichier de données.
Remarque : Un fichier de données peut être protégé par mot de passe sans être crypté et inversement. Le mot de passe est indépendant du cryptage des données. Le cryptage des données doit être configuré lors de la description du fichier de données dans l'éditeur d'analyses (Onglet "Détail").

Supprimer un mot de passe sur un fichier de données

Pour supprimer un mot de passe sur un fichier de données, il est nécessaire de faire une modification automatique des fichiers de données.
Pour cela, il suffit de faire une modification dans l'analyse (par exemple modifier la taille d'une rubrique). Dans ce cas, lors de la génération de l'analyse, une modification automatique des fichiers de données sera proposée. Vous pourrez alors modifier ou supprimer le mot de passe associé à un ou plusieurs fichiers de données.
Si vos fichiers de données sont en exploitation, il suffira lors de la création du programme d'installation de préciser qu'une modification automatique des fichiers de données doit être effectuée. Le mot de passe sera ainsi supprimé ou modifié.
Attention : si vous supprimez le mot de passe de vos fichiers de données, n'oubliez pas d'adapter votre code.
WEBDEV - Code ServeurOLE DBConnecteurs Natifs (Accès Natifs)

Gestion du mot de passe (OLE DB et Connecteurs Natifs)

Le mot de passe doit être précisé dans les paramètres de la connexion.
Classification Métier / UI : Code métier
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/06/2024

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