DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL Client/Serveur
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
Permet de connaître les droits accordés sur un fichier de données HFSQL Client/Serveur pour un utilisateur ou un groupe.
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 le fichier MonFichier.fic de la base de données MaBase
sDroits = HInfoDroitFichier("CNX", "Dupont", hDroitLecture + hDroitAjout, "MaBase", "MonFichier.fic")
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> = HInfoDroitFichier(<Connexion> , <Utilisateur/Groupe> , <Droits> , <Base de données> , <Fichier de données> [, <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.
En mode hDéfaut, <Résultat> est une liste de valeurs séparées par des tabulations (TAB). Chaque valeur de cette liste correspond au 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éL'utilisateur appartient à au moins un groupe pour lequel le droit considéré a été autorisé.
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 correspondent aux constantes utilisées dans le paramètre <Droit> 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 un fichier de données.
hDroitBlocageDroit de bloquer les fichiers ou les enregistrements d'un fichier de données.
hDroitChangeDroitDroits de changer les droits.
hDroitChangeLiaisonDroit de modifier les règles d'intégrité sur un fichier de données.
hDroitChangePropriétaireDroit de modifier le propriétaire d'un élément.
hDroitGèreDoublonDroit de brancher et de débrancher la gestion des doublons.
hDroitLectureDroit de lire les enregistrements d'un fichier de données.
hDroitMaintenanceDroit de lancer une ré-indexation ou un calcul de statistiques sur un fichier de données.
hDroitModifAutoDroit de lancer une modification automatique sur un fichier de données.
hDroitModificationDroit de modifier les enregistrements d'un fichier de données.
hDroitSuppressionDroit de supprimer les enregistrements d'un fichier de données.
hDroitSuppressionFichierDroit de supprimer un fichier de données (fonction HSupprimeFichier)
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 le fichier de données pour lequel 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.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données HFSQL présent sur le serveur pour lequel les droits sont recherchés. L'extension du fichier de données doit être précisée.
<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 le fichier de données. 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.
Remarques
Pour modifier les droits sur un fichier de données pour un utilisateur ou un groupe, utilisez la fonction HModifieDroitFichier.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

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