Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...



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


NomeTipoDescriçãoDefaultObrigatórioReferência
aUserListArrayInforme a lista de usuários que deverão ser filtrados.


aKeyValuesArrayLista 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
languagetext
linenumberstrue
[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
languagetext
linenumberstrue
[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
languagetext
linenumberstrue
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
languagetext
linenumberstrue
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
languagetext
linenumberstrue
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 cargoe-mail:


Bloco de código
languagetext
linenumberstrue
FWSFAllUsers(,{"USR_EMAIL"})


Ele retornará um array da seguinte forma:


Bloco de código
languagetext
linenumberstrue
{

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

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

}