4D Doc Center : Set user properties

4D v14.3

Set user properties


Set user properties ( refUsuario ; nome ; inicio ; senha ; numLogin ; ultLogin {; adesao {; propGrupo}} ) -> Resultado

Parâmetro	Tipo	Descrição
refUsuario	Inteiro longo	Número de ID de conta de usuário; ou -1 para adicionar um usuário afiliado com o Designer, ou -2 para adicionar um usuário afiliado com o Administrador
nome	cadeia	Novo nome de usuário
inicio	cadeia	Novo método de início
senha	cadeia	Nova senha (não criptografada); ou * para deixar a senha intocada
numLogin	Inteiro longo	Novo número de logins do banco de dados
ultLogin	Data	Nova data do último login ao banco de dados
adesao	Array inteiro longo	Números de IDs dos grupos aos quais pertence o usuário
propGrupo	Inteiro longo	Número de referência de usuário do proprietário do grupo
Resultado	Inteiro longo	Número de ID de referência do novo usuário

Descrição

Set user properties permite modificar e atualizar as propriedades de uma conta ativa de usuário existente cujo número de referência se passa no parâmetro refUsuario ou para adicionar um novo usuário afiliado ao Desenhador ou ao Administrador.

Se muda as propriedades de um usuário existente, deve passar o número de referência retornado pelo comando GET USER LIST.

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

Os números de referência para os usuários podem ser os seguintes:

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

Para adicionar um novo usuário afiliado ao Desenhador passe -1 em refUsuario. Para adicionar um novo usuário afiliado ao Administrador passe -2 em refUsuario.
Depois da chamada, se o usuário for adicionado ou modifica com sucesso, seu número de referência único é retornado em refUsuario.

Se não passa -1, -2 ou um número de referência de usuário válido, Set user properties não faz nada.

Antes de chamar este comando, passe o novo nome, método de inicio, senha, número de usos e a data do último uso do usuário, em nome, inicio, senha, numLogin e ultLogin. Passe uma senha não criptografada no parâmetro senha. 4D a criptografará por você antes de guardá-la na conta de usuário.
Se o novo nome de usuário passado em nome não for único (existe um usuário com o mesmo nome), o comando não faz nada e se retorna o erro -9979. Pode interceptar este erro com um método de gestão de erros instalado por ON ERR CALL.

Se não deseja mudar todas as propriedades do usuário (além de suas adesões, ver abaixo), primeiro chame GET USER PROPERTIES e passe os valores retornados para as propriedades que não deseja mudar.

Se não deseja modificar a senha de uma conta, passe o símbolo * no parâmetro senha. Isto permite mudar outras propriedades da conta do usuário sem mudar a senha da conta.

Se não passar o parâmetro opcional adesao, as adesões atuais do usuário permanecem iguais. Se não passar adesao quando adiciona um usuário, o usuário não formará parte de nenhum grupo.
Se passar o parâmetro opcional adesao, muda todas as adesões para o usuário. Antes de chamar este comando, deve preencher o array adesao com os números de referência únicos dos grupos cujos usuários farão parte.

Se passa o parâmetro opcional propGrupo, indica 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
	(grupo #-15001 é o primeiro grupo criado pelo Administrador,
	o grupo #-15002 é o segundo, etc.).

Para anular todas as adesões de um usuário, passe um array vazio no parâmetro adesao.

Gestão de erros

Se você não tiver os acessos de privilégio para chamar Set user properties ou se o sistema de senhas já estiver acessado para outro processo, um erro de privilégio de acesso é gerado. Você pode interceptar o erro com um método de gestão de erros instalado usando ON ERR CALL.