Gestão de Pessoas - Manual do Usuário > Customizações > Funções > RetornaDesGrupos

RetornaDesGrupo

Esta função retorna o nome do grupo do usuário.

Sintaxe: RetornaDesGrupo(Numero Iden, Alfa End Grupo);

Parâmetros:

Nome	Tipo	Descrição
Iden	Numérico	Identificador do grupo.
Grupo	Alfa	Receberá a descrição do grupo.

Exemplo:

Poderá ser feito um 'PARA' com todos os grupos do usuário ativo.

DEFINIR NUMERO x;

DEFINIR NUMERO vTotGrupos;

DEFINIR ALFA vGrupo;

vTotGrupos = RetornaQtdGrupos();

PARA (x = 1; x <= vTotGrupos; x++)

INICIO

/* O uso conjunto das duas funções possibilitará a verificação de todos os grupos a que o usuário pertence, de uma maneira rápida e fácil */

RetornaDesGrupo(x, vGrupo);

/* A função retorna a Descrição do Grupo a que o usuário pertence na variável vGrupo.

Com vGrupo definida, pode-se efetuar as verificações necessárias */

FIM;

Explicações:

Supondo que o usuário ativo pertença a 3 grupos distintos:

1) Digitadores

2) Consulta

3) Colaboradores

- A função RetornaQtdGrupos(), ao analisar o usuário ativo, retornará o número 3, pois são 3 grupos a que este usuário está associado.

- A função RetornaDesGrupo(vGrupo, 1) irá retornar "Digitadores", pois o número 1, indica à função que você está pedindo o primeiro grupo a que este colaborador está associado.

- A função RetornaDesGrupo(vGrupo, 3) irá retornar "Colaboradores" e assim sucessivamente.

- Caso informar um número que esteja fora da quantidade de grupos a qual o usuário pertença, o valor retornado será " " (vazio).

Utilização: Em todas as regras.

Observação: A função relacionada RetornaQtdGrupos() nunca retornará 0 (zero). Isto é, um usuário sempre estará associado à no mínimo 1 grupo. Porque, qualquer usuário pertence no mínimo ao grupo 'TODOS'. Quando um usuário é criado ele automaticamente é associado ao grupo todos, sendo que essa associação não pode ser desfeita.