4D Doc Center : GET USER PROPERTIES

4D v13.4

GET USER PROPERTIES


GET USER PROPERTIES ( refUsuario ; nome ; inicio ; senha ; numLogin ; ultLogin {; adesao {; propGrupo}} )

Parâmetro	Tipo	Descrição
refUsuario	Inteiro longo	Nº de referência de usuário
nome	cadeia	Nome de usuário
inicio	cadeia	Nome de método de início
senha	cadeia	Sempre é uma cadeia vazia
numLogin	Inteiro longo	Número de logins para o banco de dados
ultLogin	Data	Data do último login ao banco de dados
adesao	Array inteiro longo	Número de ID dos grupos ao qual o usuário pertence
propGrupo	Inteiro longo	Número de ID do proprietário do grupo

Descrição

GET USER PROPERTIES retorna a informação sobre o usuário cujo número de referência se passa no parâmetro refUsuario. Deve passar um número de referência de usuário retornado pelo comando GET USER LIST.

Se a conta de usuário não existir ou tiver sido apagada, se gera o erro -9979. Pode interceptar este erro com um método de gestão de erros instalado por ON ERR CALL. Senão, pode chamar Is user deleted para testar a conta de usuário antes de chamarGET USER PROPERTIES.

Os números de referência para os usuários podem ter os seguintes valores ou faixas:

Número de referência de usuário	Descrição usuário
1	Desenhador
2	Administrador
3 a 15000	Usuário criado pelo Desenhador
	(usuário #3 é o primeiro usuário criado pelo Desenhador,
	usuário #4 o segundo, etc.).
-11 a -15000	Usuário criado pelo Administrador
	(usuário #-11 é o primeiro usuário criado pelo Administrador,
	usuário #-12 o segundo, etc.).

Depois da chamada, recupera o nome, método de inicio, senha criptografada, número de logins e a data da última utilização do banco nos parâmetros nome, inicio, senha, numLogin e ultLogin.

Nota: GET USER PROPERTIES não retorna mais a senha criptografada no parâmetro senha. A partir da versão 6.0.2, sempre se retorna uma cadeia vazia em este parâmetro. Para revisar a senha de um usuário, chame a função Validate password.

Se passa o parâmetro opcional adesao, recupera os números de referência únicos dos grupos aos quais pertence o usuário.

Se passa o parâmetro opcional propGrupo, obtém o número de referência do grupo “proprietário” do usuário, ou seja o grupo proprietário por padrão dos objetos criados por este usuário.

Os números de referência para os grupos podem ser os seguintes:

Número de referência do grupo	Descrição do grupo
15001 a 32767	Grupo criado pelo Desenhador ou pelo proprietário do grupo
	(o grupo #15001 é o primeiro grupo criado pelo Desenhador,
	o grupo #15002 o segundo, etc.).
-15001 a -32768	Grupo criado pelo Administrador ou pelo proprietário do grupo
	(o grupo #-15001 é o primeiro grupo criado pelo Administrador,
	o grupo #-15002 o segundo, etc.).

Gestão de erros

Se não tiver privilégios de acesso para chamar ao comando GET USER PROPERTIES ou se outro processo abriu no sistema de senhas, um erro de privilégios de acesso é gerado. Pode interceptar este erro com un método de gestão de erros instalado por ON ERR CALL.