Ecrire proprietes utilisateur

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2004 (Modifiée)


Ecrire proprietes utilisateur (réfUtilisateur; nom; démarrage; motDePasse; nbUtilisation; dernièreUtilisation{; adhésions{; groupePropriétaire}}) Numérique

ParamètreTypeDescription
réfUtilisateurNumériqueNuméro de référence unique du compte
de l'utilisateur ou
-1 pour l'ajout d'un utilisateur affilié au
Super_Utilisateur ou
-2 pour l'ajout d'un utilisateur affilié
à l'Administrateur
nomAlphaNouveau nom de l'utilisateur
démarrageAlphaNom de la nouvelle méthode de démarrage
motDePasseAlphaNouveau mot de passe (non crypté) ou
* pour ne pas modifier le mot de passe
nbUtilisationNumériqueNouveau nombre d'utilisations de la base
dernièreUtilisationDateNouvelle date de dernière utilisation de la base
adhésionsTableau numNuméros de référence des groupes
auxquels l'utilisateur appartient
groupePropriétaireNumériqueNuméro de référence du groupe propriétaire
de l'utilisateur
RésultatNumériqueNuméro de référence unique du nouvel utilisateur

Description

Ecrire proprietes utilisateur vous permet de modifier et de mettre à jour les propriétés d'un compte actif d'utilisateur existant dont le numéro de référence est passé dans le paramètre réfUtilisateur, ou d'ajouter un nouvel utilisateur affilié soit au Super_Utilisateur soit à l'Administrateur.

Si vous modifiez les propriétés d'un utilisateur existant, vous devez passer le numéro de référence qui vous est renvoyé par la commande LIRE LISTE UTILISATEURS.

Si le compte d'utilisateur n'existe pas ou a été supprimé, Ecrire proprietes utilisateur retourne 0 et l'erreur -9979 est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs installée par APPELER SUR ERREUR. Sinon, vous pouvez appeler la fonction Utilisateur supprime pour tester le compte de l'utilisateur avant d'appeler Ecrire proprietes utilisateur.

Les numéros de référence pour les utilisateurs peuvent être les suivants :

Numéro de référenceDescription utilisateur
de l'utilisateur
1Super_Utilisateur
2Administrateur
3 à 15000Utilisateur créé par le Super_Utilisateur
(l'utilisateur n°3 est le 1er utilisateur créé par le Super_Utilisateur,
l'utilisateur n°4 est le second, et ainsi de suite).
-11 à -15000Utilisateur créé par l'Administrateur
(l'utilisateur n°-11 est le 1er utilisateur créé par l'Administrateur,
l'utilisateur n°-12 est le second, et ainsi de suite).

Si vous voulez ajouter un nouvel utilisateur affilié au Super_Utilisateur, il faut passer -1 à réfUtilisateur. Si vous voulez ajouter un nouvel utilisateur affilié à l'Administrateur, il faut passer -2 à réfUtilisateur.

Si l'utilisateur a bien été créé ou modifié, Ecrire proprietes utilisateur retourne son numéro de référence unique d'utilisateur.

Si vous ne passez pas un numéro de référence d'utilisateur valide, Ecrire proprietes utilisateur ne fait rien et retourne 0.

Lorsque vous appelez cette commande, vous passez le nouveau nom, la nouvelle méthode de démarrage, le nouveau mot de passe, le nouveau nombre d'utilisations et la nouvelle date de dernière utilisation pour l'utilisateur dans les paramètres nom, démarrage, motDePasse, nbUtilisation et dernièreUtilisation. Vous passez un mot de passe non crypté dans le paramètre motDePasse. 4D cryptera ce mot de passe avant de le sauvegarder dans le compte de l'utilisateur.

Si le nouveau nom d'utilisateur passé dans nom n'est pas unique (un utilisateur de même nom existe déjà), la commande ne fait rien et l'erreur -9979 est générée. Vous pouvez intercepter cette erreur avec une méthode de gestion d'erreurs installée par APPELER SUR ERREUR.

Si vous ne voulez pas modifier toutes les propriétés de l'utilisateur (à part son groupe, voir ci-dessous), appelez au préalable LIRE PROPRIETES UTILISATEUR et passez les valeurs retournées dans celles que vous ne voulez pas modifier. Si vous ne voulez pas modifier le mot de passe de l'utilisateur, passez * dans le paramètre motDePasse. Cela vous permet de changer les autres propriétés du compte de l'utilisateur, sans changer le mot de passe de ce compte.

Si vous ne passez pas le paramètre optionnel adhésions, les adhésions de l'utilisateur restent inchangées. Si vous ne passez pas ce paramètre en cas d'ajout d'un utilisateur, il ne fera partie d'aucun groupe.

Si vous passez le paramètre optionnel adhésions, vous modifiez toutes les adhésions pour l'utilisateur. Avant d'appeler cette commande, vous devez remplir le tableau adhésions avec les numéros de référence uniques des groupes dont l'utilisateur devra faire partie.

Si vous passez le paramètre facultatif groupePropriétaire, vous indiquez 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.

Les numéros de référence pour les groupes peuvent être les suivants :

Numéro de référenceDescription du groupe
du groupe
15001 à 32767Groupe créé par le Super_Utilisateur ou le propriétaire du groupe
(le groupe n°15001 est le 1er groupe créé par le Super_Utilisateur,
le groupe n°15002 est le second, etc.
-15001 à -32768Groupe créé par l'Administrateur ou le propriétaire du groupe
(le groupe n°-15001 est le 1er groupe créé par l'Administrateur,
le groupe n°-15002 est le second, etc.

Si vous voulez annuler les adhésions d'un utilisateur, passez un tableau vide dans le paramètre adhésion.

Référence

LIRE LISTE GROUPE, LIRE LISTE UTILISATEURS, LIRE PROPRIETES UTILISATEUR, SUPPRIMER UTILISATEUR, Utilisateur supprime, Valider mot de passe.

Gestion des erreurs

Si vous n'avez pas les privilèges d'accès pour appeler Ecrire proprietes utilisateur 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 APPELER SUR ERREUR.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant