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

Parametros

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
[n][2] Id do usuário
[n][x]... os dados pedidos pelo aKeyValues, exemplos:

FWSFALLUSERS(,{"USR_CODIGO", "USR_NOME", "USR_DEPTO"}) // Retornará o nome completo e o departamento

FWSFALLUSERS(,{"USR_CODIGO", "USR_NOME", "USR_CARGO"}) // Retornará o nome completo e o cargo

FWSFALLUSERS(,{"USR_CODIGO", "USR_NOME", "USR_EMAIL"}) // Retornará o nome completo e o e-mail

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_CODIGO", "USR_NOME", "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 cargo:

FWSFAllUsers(,{"USR_EMAIL"})

Ele retornará um array da seguinte forma:

{

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

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

}

Árvore de páginas

Versões comparadas

Versão antiga 15

Nova versão 16

Chave