Set group properties

4D v16.3


Set group properties ( réfGroupe ; nom ; propriétaire {; membres} ) -> Résultat

Paramètre	Type	Description
réfGroupe	Entier long	Numéro de référence unique du groupe activé ou -1 pour ajouter un groupe de Super_Utilisateur -2 pour ajouter un groupe d'Administrateur
nom	Chaîne	Nouveau nom de groupe
propriétaire	Entier long	Numéro de référence unique de l'utilisateur ou le propriétaire du nouveau groupe
membres	Tableau entier long	Nouveaux membres du groupe
Résultat	Entier long	Numéro de référence unique du nouveau groupe

Description

Set group properties vous permet de modifier et de mettre à jour les propriétés d'un groupe existant dont vous passez le numéro de référence unique dans réfGroupe, ou d'ajouter un nouveau groupe affilié au Super_Utilisateur ou à l'Administrateur.

Si vous modifiez les propriétés d'un groupe existant, vous devez passer son numéro de référence tel que retourné dans la commande GET GROUP LIST. Les numéros de référence de groupe sont les suivants :

Numéro de référence du groupe	Description du groupe
15001 à 32767	Groupe 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 à -32768	Groupe 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 ajouter un nouveau groupe affilié au Super_Utilisateur, passez -1 dans réfGroupe. Si vous voulez ajouter un nouveau groupe affilié à l'Administrateur, passez -2 dans réfGroupe.

Si le groupe a bien été créé, Set group properties retourne son numéro de référence unique.

Si vous ne passez pas -1, -2 ou un numéro de référence de groupe valide, Set group properties ne fait rien et retourne 0.

Avant d'appeler cette routine, vous passez le nouveau nom du groupe et le numéro du propriétaire du groupe dans les paramètres nom et propriétaire.Si vous ne voulez pas modifier toutes les propriétés du groupe (à part ses membres, voir ci-dessous), passez les valeurs retournées par GET GROUP PROPERTIES dans les paramètres que vous voulez laisser inchangés.

Si vous ne passez pas le paramètre optionnel membres, la liste courante des membres du groupe reste inchangée. Si vous le faites lors d'une création d'un groupe, le groupe n'aura pas de membres.

Note : Le propriétaire d'un groupe n'est pas automatiquement défini comme membre du groupe qu'il possède. C'est à vous de l'y inclure explicitement, à l'aide du paramètre membres.

Si vous passez le paramètre optionnel membres, vous modifiez toute la liste des membres pour ce groupe. Avant d'appeler cette routine, vous devez remplir le tableau membres avec les numéros de référence uniques des utilisateurs et/ou des groupes devant appartenir au groupe. Ces numéros peuvent être les suivants :

Numéro de référence du membre	Description membre
1	Super_Utilisateur
2	Administrateur
1 à 15000	Utilisateur 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 à -15010	Utilisateur 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).
15001 à 32767	Groupe 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.
-15011 à -32768	Groupe 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 enlever tous les membres d'un groupe, passez un tableau vide dans le paramètre membres.

Gestion des erreurs

Si vous n'avez pas les privilèges d'accès pour appeler la commande Set group 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 GROUP PROPERTIES
GET USER LIST