Set group properties

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 6.0


Set group properties (refGrupo; nombre; propietario{; miembros}) Numérico

ParámetroTipoDescripción
refGrupoNuméricoNú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
nombreAlfaNuevo nombre de grupo
propietarioNuméricoNúmero de referencia único del usuario o
del propietario del nuevo grupo
miembrosArray num.Nuevos miembros del grupo
ResultadoNuméricoNú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 Descripción del grupo

del grupo

15001 a 32767Grupo 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 -32768Grupo 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 Descripción miembro

del miembro

1Diseñador
2Administrador
3 a15000Usuario 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 -15000Usuario creado por el Administrador
(el usuario #-11 es el primer usuario creado por el Administrador,
usuario #-12 es el segundo, etc.).
15001 a 32767Grupo 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 -32768Grupo 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.

Ver también

GET GROUP LIST, GET GROUP PROPERTIES, GET USER LIST.

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.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente