Histórico da Página

...

Descrição

Para fazer um filtro no retorno, é necessário passar um array como parâmetro com o código dos usuários a serem retornados. Esse parâmetro é opcional, se não for passado à função retornará todos os usuários.

Programa Fonte

FWSFALLUSERS

Parâmetros

Nome	Tipo	Descrição	Default	Obrigatório	Referência
aUserList	Array	Informe a lista de usuários que deverão ser filtrados.
aKeyValues	Array	Lista com os campos que serão retornados, dentro da lista de permitidos.

Retorno

aUsers - Array com os usuários do sistema no seguinte formato:

Bloco de código

language	text
linenumbers	true

[n][1] Id da tabela de usuários (r_e_c_n_o_)
[n][2] Id do usuário
[n][3] Login do Usuário
[n][4] Nome do usuário
[n][5] email do usuário
[n][6] departamento do usuário
[n][7] cargo do usuário

Obs.: se passado o segundo parâmetro aKeyValues, o array de retorno ira conter a seguinte estrutura:

Bloco de código

language	text
linenumbers	true

[n][1] Id da tabela de usuários (r_e_c_n_o_)
[n][2] Id do usuário
[n][x]... os dados pedidos pelo aKeyValues

Exemplo

Bloco de código

language	text
linenumbers	true

User Function LeEmail()
Local nx
Local aAllusers := FWSFALLUSERS()
For nx := 1 To Len(aAllusers)
    conout(aAllusers[nx][4] + " -" + aAllusers[nx][5])
Next
Return

Exemplo especificando o aUserList (filtro é feito pelo ID do usuário e não pelo login)

Bloco de código

language	text
linenumbers	true

User Function LeEmail()
Local nx
Local aAllusers := FWSFALLUSERS({"000001"})
For nx := 1 To Len(aAllusers)
    conout(aAllusers[nx][4] + " -" + aAllusers[nx][5])
Next
Return

Exemplo com o parâmetro aKeyValues

Bloco de código

language	text
linenumbers	true

User Function LeEmail() 
Local nx 
Local aAllusers := FWSFALLUSERS(,{"USR_CARGO"})
For nx := 1 To Len(aAllusers) 
	conout(aAllusers[nx][4] + " -" + aAllusers[nx][5]) 
Next 
Return

Obs.: Se o aKeyValues foi especificado como no exemplo acima, independente se você solicitou ou não, ele sempre trará nas duas primeiras posições do array, o RecNo e o ID do usuário, seguido dos campos solicitados, logo se eu pedi somente o e-mail:

Bloco de código

language	text
linenumbers	true

FWSFAllUsers(,{"USR_EMAIL"})

Ele retornará um array da seguinte forma:

Bloco de código

language	text
linenumbers	true

{
  {1, "000000", "[email protected]"},

  {2, "000001", "[email protected]"}
}

Além dos exemplos acima, temos mais alguns campos que podem Campos que poderão ser retornados na aKeyValues:

MPUSR_USR
MPUSR_PRITER
MPUSR_LOGCFG
MPUSR_VINCFUNC
MPUSR_PANEIS
MPUSR_ACESSIB
USR_DEPTO
USR_MSBLQD

Campos que NÃO poderão ser retornados:

R_E_C_D_E_L_
D_E_L_E_T_
USR_CHKSUM
USR_PSWCMP

Árvore de páginas

Versões comparadas

Versão antiga 27

Nova versão 28

Chave