DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Quand utiliser la fonction <Source>.MotDePasse?
  • Définir un mot de passe sur une table
  • Supprimer un mot de passe sur une table
  • Gestion du mot de passe (OLE DB et Connecteurs Natifs)
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Fixe le mot de passe utilisé pour créer ou pour ouvrir une table. Le mot de passe est stocké et sera utilisé lors de l'ouverture ou de la création de la table, 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 de la table dans l'éditeur de schémas des données (Onglet "Détail").
  • Ce mot de passe peut aussi être spécifié directement dans les fonctions de création (<Source>.Crée, <Source>.CréeSiInexistant) et d'ouverture de la table (<Source>.Ouvre).
  • 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.
Java Accès par JDBC: Cette fonction n'est pas disponible pour les bases de données accédées par JDBC.
Exemple
// Ouverture d'un fichier de données avec mot de passe et contrôle d'erreur
Client.MotDePasse("MotDePasse")
SI Client.CréationSiInexistant() = Faux ALORS
	Erreur("Erreur HFSQL : " + HErreurInfo())
	RETOUR
FIN
// <Source>.ErreurMotDePasse permet de savoir si l'erreur rencontrée est une erreur de mot de passe
SI Client.Cré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> = <Source>.MotDePasse([<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é.
<Source> : Type correspondant à la source spécifiée
Nom de la table utilisant un mot de passe.
Si la table est déclarée avec la fonction <Source>.DéclareExterne, <Source> correspond au nom de l'alias de la table.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe associé à la table.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), aucun mot de passe n'est défini pour la table. La taille du mot de passe n'est pas limitée.
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
HFSQL ClassicHFSQL Client/Serveur Le mot de passe des tables HFSQL est insensible à la casse.
Remarques

Quand utiliser la fonction <Source>.MotDePasse?

La fonction <Source>.MotDePasse doit être appelée:
Remarques:
  • Si un mot de passe est précisé dans les fonctions d'ouverture ou de création explicites (fonctions <Source>.Ouvre, <Source>.Crée, <Source>.CréeSiInexistant), le mot de passe précisé dans la fonction <Source>.MotDePasse n'est pas pris en compte.
  • Le mot de passe des tables HFSQL est insensible à la casse.
  • Pour changer un mot de passe sur une table existante ou ajouter un mot de passe sur une table créée sans mot de passe, il faut utiliser la fonction <Source>.ChangeMotDePasse.

Définir un mot de passe sur une table

Une table sera protégée par mot de passe uniquement si:
  • soit la fonction <Source>.MotDePasse a été utilisée avant la fonction de création de la table (fonctions <Source>.Crée et <Source>.CréeSiInexistant),
  • soit le mot de passe a été précisé directement dans la fonction de création de la table.
Remarque: Une table peut être protégée par mot de passe sans être cryptée 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 de la table dans l'éditeur de schémas des données (Onglet "Détail").

Supprimer un mot de passe sur une table

Pour supprimer un mot de passe sur une table, il est nécessaire de faire une modification automatique des tables.
Pour cela, il suffit de faire une modification dans le schéma des données (par exemple modifier la taille d'une rubrique). Dans ce cas, lors de la génération du schéma des données, une modification automatique des tables sera proposée. Vous pourrez alors modifier ou supprimer le mot de passe associé à une ou plusieurs tables.
Si vos tables sont en exploitation, il suffira lors de la création du programme d'installation de préciser qu'une modification automatique des tables doit être effectuée. Le mot de passe sera ainsi supprimé ou modifié.
Attention: si vous supprimez le mot de passe de vos tables, n'oubliez pas d'adapter votre code.
WINDEVWEBDEV - 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 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 05/12/2024

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