GET USER PROPERTIES
GET USER PROPERTIES ( réfUtilisateur ; nom ; démarrage ; motDePasse ; nbUtilisations ; dernièreUtilisation {; adhésions {; groupePropriétaire}} )
| Paramètre | Type | Description | |
|---|---|---|---|
| réfUtilisateur | Integer | → | Numéro de référence unique de l'utilisateur |
| nom | Text | ← | Nom de l'utilisateur |
| démarrage | Text | ← | Nom de la méthode de démarrage |
| motDePasse | Text | ← | *** obsolète (chaîne vide) *** |
| nbUtilisations | Integer | ← | Nombre d'utilisations de la base |
| dernièreUtilisation | Date | ← | Date de la dernière utilisation de la base |
| adhésions | Integer array | ← | Numéros de référence des groupes auxquels l'utilisateur appartient |
| groupePropriétaire | Integer | ← | Numéro de référence du groupe propriétaire de l’utilisateur |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
GET USER PROPERTIES retourne les informations concernant l'utilisateur dont le numéro de référence est passé dans le paramètre réfUtilisateur. Vous devez passer le numéro de référence retourné par la commande GET USER LIST.
Si le compte d'utilisateur n'existe pas ou a été supprimé, l'erreur -9979 est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs installée par ON ERR CALL. Sinon, vous pouvez appeler la fonction Is user deleted pour tester le compte de l'utilisateur avant d'appeler GET USER PROPERTIES.
Après l'appel, vous récupérez le nom, la méthode de démarrage, le nombre d'utilisations et la date de la dernière utilisation de la base dans les paramètres nom, démarrage, nbUtilisation et dernièreUtilisation.
Notes :
- Les paramètres nbUtilisation et dernièreUtilisation sont utilisés uniquement dans les bases binaires. Ils retournent toujours, respectivement, 0 et 00/00/00 dans les bases projets.
- Le paramètre motDePasse est obsolète (il retourne toujours une chaîne vide). Si vous souhaitez contrôler le mot de passe d'un utilisateur, utilisez la fonction Validate password
Si vous passez le paramètre optionnel adhésion, vous récupérez le numéro de référence unique du groupe auquel l'utilisateur appartient.
(Bases binaires uniquement) Vous pouvez passer le paramètre optionnel groupePropriétaire pour lire le numéro de référence du groupe "propriétaire" de l'utilisateur, c'est-à-dire le groupe propriétaire par défaut des objets créés par cet utilisateur.
Note : Le tableau groupePropriétaire retourne toujours la valeur 0 dans les bases projets.
Note pour les bases binaires : Les valeurs des références des groupes et des utilisateurs sont fonction de la personne qui les crée (Super Utilisateur, Administrateur, ou propriétaire du groupe affilié). Pour plus d'informations, veuillez consulter le paragraphe Plages de références des groupes et des utilisateurs.
Gestion des erreurs
Si vous n'avez pas les privilèges d'accès pour appeler la commande GET USER PROPERTIES ou si le système de Mots de passe est déjà ouvert par un autre process, une erreur de privilège d'accès est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs installée par ON ERR CALL.
Voir aussi
GET GROUP LIST
GET USER LIST
Is user deleted
Set user properties
Validate password