GET USER PROPERTIES
GET USER PROPERTIES ( refUsuario ; nombre ; inicio ; contraseña ; nbLogin ; ultimoLogin {; membrecias {; grupoPropietario}} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| refUsuario | Integer | → | Número de referencia único de usuario |
| nombre | Text | ← | Nombre del usuario |
| inicio | Text | ← | Nombre del método de inicio |
| contraseña | Text | ← | Cadena vacía |
| nbLogin | Integer | ← | Números de usos de la base |
| ultimoLogin | Date | ← | Fecha de la última utilización de la base |
| membrecias | Integer array | ← | Números de referencia de los grupos a los que el usuario pertenece |
| grupoPropietario | Integer | ← | Número de referencia del grupo prioritario del usuario |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
GET USER PROPERTIES devuelve la información sobre el usuario cuyo número de referencia se pasa en el parámetro refUsuario. Debe pasar un número de referencia de usuario devuelto por el comando GET USER LIST.
Si la cuenta de usuario no existe o ha sido borrada, se genera el error -9979. Puede interceptar este error con un método de gestión de errores instalado por ON ERR CALL. Sino, puede llamar Is user deleted para probar la cuenta de usuario antes de llamar GET USER PROPERTIES.
Después de la llamada, recupera el nombre, método de inicio, número de usos y la fecha de la última utilización de la base en los parámetros nombre, inicio, nbLogin y ultimoLogin.
Notas:
- Los parámetros nbLogin y ultimoLogin se utilizan solo en bases binarias. Siempre devuelven respectivamente 0 y 00/00/00 en las bases proyecto.
- el parámetro contraseña es obsoleto (siempre devuelve una cadena vacía). Si desea verificar la contraseña de un usuario, utilice la función Validate password.
Si pasa el parámetro opcional membresias, recupera los números de referencia únicos de los grupos a los cuales pertenece el usuario.
(B ases binarias únicamente) Puede pasar el parámetro opcional grupoProp para obtener el número de referencia del grupo “propietario” del usuario, es decir el grupo propietario por defecto de los objetos creados por este usuario.
Nota: The groupOwner array always returns 0 values in project databases.
Nota para bases binarias: los valores de ID de grupo y usuario dependen de su creador (Diseñador, Administrador o propietario del grupo afiliado). Para más información, consulte el párrafo Rangos de identificaciones de usuarios y grupos.
Gestión de errores
Si no tiene privilegios de acceso para llamar al comando GET 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.
Ver también
GET GROUP LIST
GET USER LIST
Is user deleted
Set user properties
Validate password