Set group properties

4D v16.3


Set group properties ( refGrupo ; nombre ; propietario {; miembros} ) -> Resultado

Parámetro	Tipo	Descripción
refGrupo	Entero largo	Número de referencia único del grupo activo o -1 para añadir un grupo de Diseñador o -2 para añadir un grupo de Administrador
nombre	Cadena	Nuevo nombre de grupo
propietario	Entero largo	Número de referencia único del usuario o del propietario del nuevo grupo
miembros	Array entero largo	Nuevos miembros del grupo
Resultado	Entero largo	Número de referencia único del nuevo grupo

Descripción

Set group properties permite modificar y actualizar las propiedades de un grupo existente cuyo número de referencia único se pasa en refGrupo, o para añadir un nuevo grupo afiliado al Diseñador o al Administrador.

Si modifica las propiedades de un grupo existente, debe pasar un número de referencia válido devuelto por el comando GET GROUP LIST. Los números de referencia de grupo son los siguientes:

Número de referencia del grupo	Descripción del grupo
15001 a 32767	Grupo creado por el Diseñador o el propietario del grupo
	(el grupo #15001 es el primer grupo creado por el Diseñador,
	el grupo #15002 el segundo, etc.).
-15001 a -32768	Grupo creado por el Administrador o por el propietario del grupo
	(el grupo #-15001 el el primer grupo creado por el Administrador,
	el grupo #-15002 el segundo, etc.).

Para añadir un nuevo grupo afiliado con el Diseñador, pase -1 en RefGrupo. Para añadir un nuevo grupo afiliado al Administrador, pase -2 en refGrupo. Después de la llamada, si el grupo se añadió con éxito, devuelve su número de referencia único en refGrupo.

Si no pasa -1, -2 o un número de referencia de grupo válido, Set group properties no hace nada y devuelve 0.

Antes de llamar esta rutina, pase el nuevo nombre del grupo y el número de propietario del grupo en los parámetros nombre y propietario.Si no quiere cambiar las propiedades del grupo (a parte de los miembros, ver más adelante), primero llame GET GROUP PROPERTIES y pase los parámetros que quiere dejar intactos.

Si no pasa el parámetro opcional miembros, la lista actual de miembros del grupo permanece sin cambios. Si no pasa miembros mientras añade un grupo, el grupo no tendrá miembros.

Nota: el propietario de un grupo no está definido automáticamente como miembro del grupo que posee. Es su decisión incluir al propietario del grupo en el grupo, utilizando el parámetro miembros.

Si pasa el parámetro opcional miembros, modifica toda la lista de miembros para este grupo. Antes de llamar esta rutina, debe llenar el array miembros con los números de referencia únicos de los usuarios y grupos que el grupo tendrá como miembros. Los números de referencia de los miembros pueden tener los siguientes rangos:

Número de referencia del miembro	Descripción miembro
1	Diseñador
2	Administrador
3 a15000	Usuario creado por el Diseñador
	(el usuario #3 es el primer usuario creado por el Diseñador,
	el usuario #4 es el segundo, etc.).
-11 a -15000	Usuario creado por el Administrador
	(el usuario #-11 es el primer usuario creado por el Administrador,
	usuario #-12 es el segundo, etc.).
15001 a 32767	Grupo creado por el Diseñador o Propietario del grupo
	(el grupo #15001 es el primer grupo creado por el Diseñador,
	el grupo #15002 es el segundo, etc.).
-15001 a -32768	Grupo creado por el Administrador o Propietario del grupo
	(el grupo #-15001 es el primer grupo creado por el Administrador,
	el grupo #-15002 es el segundo, etc.).

Para eliminar todos los miembros de un grupo, pase un array vacío en el parámetro miembros.

Gestión de errores

Si no tiene privilegios de acceso para llamar al comando Set group properties o si otro proceso abrió en el sistema de contraseñas, se genera un error de privilegios de acceso. Puede interceptar este error con un método de gestión de errores instalado por ON ERR CALL.

Ver también

GET GROUP LIST
GET GROUP PROPERTIES
GET USER LIST