4D v16.3

Set group properties

Página Inicial

 
4D v16.3
Set group properties

Set group properties 


 

Set group properties ( refGrupo ; nome ; proprietario {; membros} ) -> Resultado 
Parâmetro Tipo   Descrição
refGrupo  Inteiro longo in Número de ID do grupo; ou -1 para adicionar um grupo Designer, ou -2 para adicionar um grupo Administrador
nome  String in Novo nome do grupo
proprietario  Inteiro longo in Número de ID do novo proprietário do grupo
membros  Array inteiro longo in Novos membros do grupo
Resultado  Inteiro longo in Nº de ID do novo grupo

Set group properties permite modificar e atualizar as propriedades de um grupo existente cujo número de referência único se passa em refGrupo, ou para adicionar um novo grupo afiliado ao Desenhador ou ao Administrador.

Se modificar as propriedades de um grupo existente, deve passar um número de referência válido retornado pelo comando GET GROUP LIST. Os números de referência de grupo podem ter os seguintes valores ou faixas:

Número de referência do grupoDescrição do grupo
15001 a 32767Grupo criado pelo Desenhador ou o 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
(o grupo #-15001 o o primeiro grupo criado pelo Administrador,
o grupo #-15002 o segundo, etc.).

Para adicionar um novo grupo afiliado com o Desenhador, passe -1 em refGrupo. Para adicionar um novo grupo afiliado ao Administrador, passe -2 em refGrupo. Depois da chamada, se o grupo for adicionado com sucesso, retorna seu número de referência único em refGrupo.

Se não passa -1, -2 ou um número de referência de grupo válido,  Set group properties não faz nada e retorna 0.

Antes de chamar esta rotina, passe o novo nome do grupo e o número de proprietário do grupo nos parâmetros nome e proprietario.Se não deseja mudar as propriedades do grupo (a parte dos membros, ver mais adiante), primeiro chame GET GROUP PROPERTIES e passe os parâmetros que deseja deixar intactos.

Se não passar o parâmetro opcional membros, a lista atual de membros do grupo permanece sem mudanças. Se não passar membros enquanto adiciona um grupo, o grupo não terá membros.

Nota: o proprietário de um grupo não está definido automaticamente como membro do grupo que possuir. É sua decisão incluir ao proprietário do grupo no grupo, utilizando o parâmetro membros.

Se passa o parâmetro opcional membros, modifica toda a lista de membros para este grupo. Antes de chamar esta rotina, deve preencher o array membros com os números de referência únicos dos usuários e grupos que o grupo terá como membros. Os números de referência dos membros podem ter as seguintes faixas:

Número de referência do membroDescrição membro
1Desenhador
2Administrador
3 a15000Usuá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,
usuário #-12 é o segundo, etc.).
15001 a 32767Grupo criado pelo Desenhador ou 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 Proprietário do grupo
(o grupo #-15001 é o primeiro grupo criado pelo Administrador,
o grupo #-15002 é o segundo, etc.).


Para eliminar todos os membros de um grupo, passe um array vazio no parâmetro membros.

Se você não tiver os acessos de privilégio para chamar Set group 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 

GET GROUP LIST
GET GROUP PROPERTIES
GET USER LIST

 
PROPRIEDADES 

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

Este comando modifica a variável sistema Error

 
HISTÓRIA 

Criado por: 4D v6

 
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)