4D v14.3

Ecrire proprietes groupe

Accueil

 
4D v14.3
Ecrire proprietes groupe

Ecrire proprietes groupe 


 

Ecrire proprietes groupe ( réfGroupe ; nom ; propriétaire {; membres} ) -> Résultat 
Paramètre Type   Description
réfGroupe  Entier long in 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 in Nouveau nom de groupe
propriétaire  Entier long in Numéro de référence unique de l'utilisateur ou le propriétaire du nouveau groupe
membres  Tableau entier long in Nouveaux membres du groupe
Résultat  Entier long in Numéro de référence unique du nouveau groupe

Ecrire proprietes groupe 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 LIRE LISTE GROUPE. Les numéros de référence de groupe sont les suivants :

Numéro de référence du groupeDescription 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 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éé, Ecrire proprietes groupe 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, Ecrire proprietes groupe 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 LIRE PROPRIETES GROUPE 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 membreDescription membre
1Super_Utilisateur
2Administrateur
1 à 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 à -15010Utilisateur 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 à 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.
-15011 à -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 enlever tous les membres d'un groupe, passez un tableau vide dans le paramètre membres.

Si vous n'avez pas les privilèges d'accès pour appeler la commande Ecrire proprietes groupe 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.

 
PROPRIÉTÉS 

Produit : 4D
Thème : Utilisateurs et groupes
Numéro : 614
Nom intl. : Set group properties

Cette commande modifie la variable système Error

 
HISTORIQUE 

Créé : 4D v6

 
VOIR AUSSI  

LIRE LISTE GROUPE
LIRE LISTE UTILISATEURS
LIRE PROPRIETES GROUPE

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v12.4)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)