4D v16.3

Set user properties

Página Inicial

 
4D v16.3
Set user properties

Set user properties 


 

Set user properties ( refUsuario ; nome ; inicio ; senha ; numLogin ; ultLogin {; adesao {; propGrupo}} ) -> Resultado 
Parâmetro Tipo   Descrição
refUsuario  Inteiro longo in 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  String in Novo nome de usuário
inicio  String in Novo método de início
senha  String in Nova senha (não criptografada); ou * para deixar a senha intocada
numLogin  Inteiro longo in Novo número de logins do banco de dados
ultLogin  Data in Nova data do último login ao banco de dados
adesao  Array inteiro longo in Números de IDs dos grupos aos quais pertence o usuário
propGrupo  Inteiro longo in Número de referência de usuário do proprietário do grupo
Resultado  Inteiro longo in Número de ID de referência do novo usuário

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árioDescrição usuário
1Desenhador
2Administrador
3 a 15000Usuário criado pelo Desenhador
(o usuário #3 é o primeiro usuário criado pelo Desenhador,
o usuário #4 o segundo, etc.).
-11 a -15000Usuá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 grupoDescrição do grupo
15001 a 32767Grupo 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 -32768Grupo 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.

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.



Ver também 

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

 
PROPRIEDADES 

Produto: 4D
Tema: Usuário e Grupos
Número 612

 
HISTÓRIA 

Modificado: 4D 2004

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)