Aller au contenu principal
Version: 20 R7 BETA

GET USER PROPERTIES

GET USER PROPERTIES ( réfUtilisateur ; nom ; démarrage ; motDePasse ; nbUtilisations ; dernièreUtilisation {; adhésions {; groupePropriétaire}} )

ParamètreTypeDescription
réfUtilisateurInteger→Numéro de référence unique de l'utilisateur
nomText←Nom de l'utilisateur
démarrageText←Nom de la méthode de démarrage
motDePasseText←*** obsolète (chaîne vide) ***
nbUtilisationsInteger←Nombre d'utilisations de la base
dernièreUtilisationDate←Date de la dernière utilisation de la base
adhésionsInteger array←Numéros de référence des groupes auxquels l'utilisateur appartient
groupePropriétaireInteger←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