|
|
|
|
|
HInfoDroitFichier (Fonction) En anglais : HInfoFileRights
Disponible uniquement avec ce type de connexion
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
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. | hInterdit | L'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 : | | hDroitAjout | Droit d'ajouter de nouveaux enregistrements dans un fichier de données. | hDroitBlocage | Droit de bloquer les fichiers ou les enregistrements d'un fichier de données. | hDroitChangeDroit | Droits de changer les droits. | hDroitChangeLiaison | Droit de modifier les règles d'intégrité sur un fichier de données. | hDroitChangePropriétaire | Droit de modifier le propriétaire d'un élément. | hDroitDésanonymisation | Droit de désanonymiser les rubriques anonymisées présentes dans un fichier de données. | hDroitGèreDoublon | Droit de brancher et de débrancher la gestion des doublons. | hDroitLecture | Droit de lire les enregistrements d'un fichier de données. | hDroitMaintenance | Droit de lancer une ré-indexation ou un calcul de statistiques sur un fichier de données. | hDroitModifAuto | Droit de lancer une modification automatique sur un fichier de données. | hDroitModification | Droit de modifier les enregistrements d'un fichier de données. | hDroitSuppression | Droit de supprimer les enregistrements d'un fichier de données. | hDroitSuppressionFichier | Droit de supprimer un fichier de données (fonction HSupprimeFichier) | hDroitTous | Liste 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étail | Idem hDéfaut. <Résultat> contient le droit et sa valeur. | hEffectif | Le 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étail | Idem 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|