Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

AllGroups

AllGroups( [lAlfa] ) --> aGroups

Consulta a estrutura histórica de grupos de usuários.

AllGroupsAdvPL
01 · VISÃO GERAL

Visão geral

A documentação consultada abrange as versões 5.07 a 7.10 e retorna um array multidimensional de grupos. lAlfa escolhe ordenação por nome (.T.) ou código (.F., padrão); não é uma autorização para alterar dados. A estrutura histórica contém nome, horários e configurações de acesso e impressão. O exemplo conta grupos, sem registrar dados completos. Esta ficha é referência de legado: não comprova suporte no release atual nem equivalência com outras APIs de segurança. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

AllGroups( [lAlfa] ) --> aGroups

Parâmetros

lAlfa
LógicoOpcional

Ordenar por nome se .T.; por código se .F. (padrão).

Retorno

Array multidimensional conforme a documentação histórica; validar o layout no ambiente.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function EdAllgrou()
    // Exige ambiente legado compativel e sessao autorizada.
    Local aGrupos := AllGroups(.F.)
    If ValType(aGrupos) == "A"
        // Somente quantidade; nao despejar configuracoes de acesso no log.
        ConOut(cValToChar(Len(aGrupos)))
    EndIf
Return Nil
Resultado esperado

Propõe a contagem dos registros retornados no ambiente compatível; nenhum grupo é alterado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não usar a posição no array como identificador permanente. Não inferir permissão efetiva apenas pela existência de um grupo no cadastro.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. AllGroups. TDN. Consulta em 2026-10-25.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha