DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL Client/Serveur
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HInfoDroitVue (Fonction)
En anglais : HInfoViewRights
HFSQL Client/ServeurDisponible uniquement avec ce type de connexion
Permet de connaître les droits accordés sur une vue SQL ou sur une vue matérialisée pour un utilisateur ou un groupe.
Exemple
sDroits est une chaîne
sUnDroit est une chaîne
// Récupère les droits de lecture et d'ajout de l'utilisateur Dupont 
// sur la vue MaVueClient de la base de données MaBase
sDroits = HInfoDroitVue("CNX", "Dupont", hDroitLecture + hDroitAjout, ...
		"MaBase", "MaVueClient")
sUnDroit = ExtraitChaîne(sDroits, rangPremier, TAB)
TANTQUE sUnDroit <> EOT
	SELON sUnDroit
		CAS hAutorisé
		...
		CAS hInterdit
		...
		CAS hHérité
		... 
	FIN
	sUnDroit = ExtraitChaîne(sDroits, rangSuivant, TAB)
FIN
Syntaxe
<Résultat> = HInfoDroitVue(<Connexion> , <Utilisateur/Groupe> , <Droits> , <Base de données> , <Vue> [, <Mode d'affichage>])
<Résultat> : Chaîne de caractères
  • Informations demandées,
  • Chaîne vide ("") en cas d'erreur.
  • "Utilisateur inconnu" ou "Groupe inconnu" si l'utilisateur en cours n'a pas le droit de visualisation des utilisateurs (constante hDroitVisualisationUtilisateur) et s'il demande des informations concernant un autre utilisateur ou groupe.
Les informations demandées varient selon le paramètre <Mode d'affichage du résultat> :
  • En mode hDéfaut, <Résultat> est une liste de valeurs séparée par des tabulations (TAB).
    <Valeur du droit 1> + TAB + ... + TAB + <Valeur du droit N>

    où <Valeur du droit> correspond à la valeur du droit demandé par le paramètre <Droits>. Chaque valeur de cette liste peut correspondre à l'une des constantes suivantes :
    hAutoriséL'utilisateur ou le groupe a le droit considéré.
    hHéritéLe droit est indéfini à ce niveau pour l'utilisateur (ou le groupe auquel il appartient). Le serveur HFSQL utilise le droit défini au niveau supérieur pour l'utilisateur (ou le groupe auquel il appartient). Pour une vue, le serveur HFSQL utilise le droit défini pour l'utilisateur (ou le groupe auquel il appartient) au niveau de la base de données.
    Cette constante est renvoyée uniquement si le mode d'affichage n'est pas hEffectif.
    hInterditL'utilisateur ou le groupe n'a pas le droit considéré.
  • En mode hDétail, <Résultat> est une liste de valeurs de la forme :
    <Droit considéré 1> + TAB + <Valeur du droit 1> + RC + ...
    <Droit considéré N> + TAB + <Valeur du droit N> + RC

Les droits considérés correspondent aux constantes utilisées dans le paramètre <Droits> et les valeurs du droit correspondent aux constantes hAutorisé, hInterdit ou hHérité (voir tableau ci-dessus).
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion pour laquelle les droits d'un utilisateur ou d'un groupe d'utilisateurs doivent être connus. Cette connexion correspond :
<Utilisateur/Groupe> : Chaîne de caractères
Nom de l'utilisateur ou du groupe dont on veut connaître les droits.
<Droits> : Constante ou combinaison de constantes de type Entier
Liste des droits à rechercher :
hDroitAjoutDroit d'ajouter de nouveaux enregistrements dans une vue.
hDroitChangeDroitDroits de changer les droits.
hDroitLectureDroit de lire les enregistrements d'une vue.
hDroitMaintenanceDroit de lancer une ré-indexation ou un calcul de statistiques sur une vue matérialisée.
hDroitModificationDroit de modifier les enregistrements d'une vue.
hDroitSuppressionDroit de supprimer les enregistrements d'une vue.
hDroitSuppressionVueDroit de supprimer une vue.
hDroitTousListe de tous les droits.
Il est conseillé d'utiliser cette constante en mode d'affichage hDétail ou hEffectif + hDétail.
<Base de données> : Chaîne de caractères
Nom de la base de données contenant la vue (SQL ou matérialisée) pour laquelle les droits sont recherchés.
  • Si la base de données correspond à la base de données définie dans la connexion, ce paramètre peut correspondre à une chaîne vide ("").
  • Si aucune base de données n'est définie dans la connexion et si ce paramètre correspond à une chaîne vide, une erreur WLangage est affichée.
<Vue> : Chaîne de caractères
Nom de la vue SQL ou de la vue matérialisée présente sur le serveur pour laquelle les droits sont recherchés.
<Mode d'affichage> : Constante optionnelle de type Entier
Mode d'affichage du résultat :
hDéfaut
(Valeur par défaut)
Le droit renvoyé ne tient pas compte des droits qui seront éventuellement hérités (par exemple, les droits définis pour les groupes auxquels l'utilisateur appartient).
Si le droit n'a pas été défini, la valeur de ce droit sera hHérité.
<Résultat> contient uniquement les valeurs des droits demandés (dans le même ordre).
hDétailIdem hDéfaut.
<Résultat> contient le droit et sa valeur.
hEffectifLe droit renvoyé correspond au droit qui sera effectivement appliqué pour l'utilisateur ou le groupe sur la vue. Les droits éventuellement hérités sont pris en compte (par exemple, les droits définis pour les groupes auxquels l'utilisateur appartient).
hEffectif + hDétailIdem hEffectif.
<Résultat> contient le droit et sa valeur.
Composante : wd300hf.dll
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/02/2025

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