Ecrire proprietes groupe

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 6.0


Ecrire proprietes groupe (réfGroupe; nom; propriétaire{; membres}) Numérique

ParamètreTypeDescription
réfGroupeNumériqueNumé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
nomAlphaNouveau nom de groupe
propriétaireNumériqueNuméro de référence unique de l'utilisateur ou
le propriétaire du nouveau groupe
membresTableau numNouveaux membres du groupe
RésultatNumériqueNuméro de référence unique du nouveau groupe

Description

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 Description 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 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érenceDescription membre
du 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.

Référence

LIRE LISTE GROUPE, LIRE LISTE UTILISATEURS, LIRE PROPRIETES GROUPE.

Gestion des erreurs

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.


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