4D Doc Center : Set group properties

4D v14.3

Set group properties


Set group properties ( refGrupo ; nome ; proprietario {; membros} ) -> Resultado

Parâmetro	Tipo	Descrição
refGrupo	Inteiro longo	Número de ID do grupo; ou -1 para adicionar um grupo Designer, ou -2 para adicionar um grupo Administrador
nome	cadeia	Novo nome do grupo
proprietario	Inteiro longo	Número de ID do novo proprietário do grupo
membros	Array inteiro longo	Novos membros do grupo
Resultado	Inteiro longo	Nº de ID do novo grupo

Descrição

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 grupo	Descrição do grupo
15001 a 32767	Grupo 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 -32768	Grupo 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 membro	Descrição membro
1	Desenhador
2	Administrador
3 a15000	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,
	usuário #-12 é o segundo, etc.).
15001 a 32767	Grupo 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 -32768	Grupo 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.

Gestão de erros

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.