Set user 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 2004 (Modificado)


Set user properties (refUsuario; nombre; inicio; contraseña; nbLogin; ultimoLogin{; membrecias{; grupoPropietario}}) Numérico

ParámetroTipoDescripción
refUsuarioNuméricoNúmero de referencia único de cuenta del usuario o
-1 para añadir un usuario afiliado al Diseñador o
-2 para añadir un usuario afiliado al Administrador
nombreAlfaNuevo nombre de usuario
inicioAlfaNombre del nuevo método de inicio
contraseñaAlfaNueva contraseña (encriptada) o
* para no modificar la contraseña
nbLoginNuméricoNuevo número de usos de la base
ultimoLoginFechaNueva fecha de la última utilización de la base
membreciasArray num.Números de referencia de los grupos a los que pertenece el usuario
grupoPropietarioNuméricoNúmero de referencia del grupo propietario del usuario
ResultadoNuméricoNúmero de referencia único del nuevo usuario

Descripción

Set user properties permite modificar y actualizar las propiedades de una cuenta activa de usuario existente cuyo número de referencia se pasa en el parámetro refUsuario, o para añadir un nuevo usuario afiliado al Diseñador o al Administrador.

Si cambia las propiedades de un usuario existente, debe pasar el número de referencia devuelto por el comando GET USER LIST.

Si la cuenta de usuario no existe o se ha borrado, se genera el error -9979. Puede interceptar este error con un método de gestión de errores instalado por ON ERR CALL. De lo contrario, puede llamar Is user deleted para probar la cuenta de usuario antes de llamar Set user properties.

Los números de referencia para los usuarios pueden ser los siguientes:

Número de referencia Descripción usuario

del usuario

1Diseñador
2Administrador
3 a 15000Usuario creado por el Diseñador
(el usuario #3 es el primer usuario creado por el Diseñador,
el usuario #4 el segundo, etc.).
-11 a -15000Usuario creado por el Administrador
(el usuario #-11 es el primer usuario creado por el Administrador,
el usuario #-12 el segundo, etc.).

Para añadir un nuevo usuario afiliado al Diseñador pase -1 en refUsuario. Para añadir un nuevo usuario afiliado al Administrador pase -2 en refUsuario.

Después de la llamada, si el usuario se añade o modifica con éxito, su número de referencia único es devuelto en refUsuario.

Si no pasa -1, -2 o un número de referencia de usuario válido, Set user properties no hace nada.

Antes de llamar este comando, pase el nuevo nombre, método de inicio, contraseña, número de usos y la fecha del último uso del usuario, en nombre, inicio, contraseña, nbLogin y ultimoLogin. Pase una contraseña no encriptada en el parámetro contraseña. 4D la encriptará por usted antes de guardarla en la cuenta de usuario.

Si el nuevo nombre de usuario pasado en nombre no es único (existe un usuario con el mismo nombre), el comando no hace nada y se devuelve el error -9979. Puede interceptar este error con un método de gestión de errores instalado por ON ERR CALL.

Si no quiere cambiar todas las propiedades del usuario (a parte de su grupo, ver a continuación), primero llame GET USER PROPERTIES y pase los valores devueltos para las propiedades que no quiere cambiar.

Si no quiere modificar la contraseña de una cuenta, pase el símbolo * en el parámetro contraseña. Esto le permite cambiar otras propiedades de la cuenta del usuario sin cambiar la contraseña de la cuenta.

Si no pasa el parámetro opcional membrecias, las membrecías actuales del usuario permanecen iguales. Si no pasa membrecias cuando añade un usuario, el usuario no formará parte de ningún grupo.

Si pasa el parámetro opcional membrecias, cambia todas las membrecías para el usuario. Antes de llamar este comando, debe llenar el array membrecias con los números de referencia únicos de los grupos cuyos usuarios harán parte.

Si pasa el parámetro opcional grupoPropietario, indica el número de referencia del grupo "propietario", del usuario, es decir el grupo propietario por defecto de los objetos creados por este usuario.

Los números de referencia para los grupos pueden ser los siguientes:

Número de referencia Descripción del grupo

del grupo

15001 a 32767Grupo creado por el Diseñador o por el 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 por el Propietario del grupo
(grupo #-15001 es el primer grupo creado por el Administrador,
el grupo #-15002 es el segundo, etc.).

Para anular todas las membrecías de un usuario, pase un array vacío en el parámetro membrecias.

Ver también

DELETE USER, GET GROUP LIST, GET USER LIST, GET USER PROPERTIES, Is user deleted, Validate password.

Gestión de errores

Si no tiene privilegios de acceso para llamar al comando Set user 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