| Composition Setup |
|---|
import.css=/download/attachments/327912/newLayout.css |
Esta função carrega todos os registros do cadastro de usuários.
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
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. |
|
|
|
| RESERVADO |
|
|
|
|
|
| RESERVADO |
|
|
|
|
|
| lBlock | Logical | Retorna a informação sobre o bloqueio do usuário | .F. |
|
|
| lQueryInFilter | Logical | Se .T. insere a lista de usuários em uma clausula 'IN' ao fazer a query (somente para banco de dados) | .T. |
|
|
| Informações |
|---|
|
O retorno da função FWSFALLUSERS sempre será ordenada do menor código para o maior. Ex.: FWSFALLUSERS({"000001","000000","000002"}) o retorno será 000000,000001,000002 Se no array de usuários for passado o mesmo código mais de uma vez, o mesmo será ignorado. |
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:
Além dos exemplos acima, temos mais alguns campos que podem ser retornados na aKeyValues:MPUSR_USRMPUSR_PRITERMPUSR_LOGCFGMPUSR_VINCFUNCMPUSR_PANEISMPUSR_ACESSIBUSR_DEPTOUSR_MSBLQD
Lista de campos retornáveis pelo parâmetro aKeyValues:
CAMPOS | NOMES DOS CAMPOS |
|---|
"USR_DTINC" | Data de inclusão |
| "USR_ALLEMP" | Habilitar todas as empresas |
| "USR_NOME" | Nome completo do usuário |
| "USR_EMAIL" | E-mail |
| "USR_DEPTO" | Departamento |
| "USR_CARGO" | Cargo |
| "USR_ANO" | Número de dígitos do ano |
| "USR_ENVIMP" | Ambiente de impressão padrão |
| "USR_TIPOIMP" | Tipo de impressão padrão |
| "USR_FORMATOIMP" | Formato de impressão padrão |
| "USR_NOMEIMP" | Nome da impressora padrão |
| "USR_DRIVEIMP" | Driver da impressora padrão |
| "USR_PORTAIMP" | Porta da impressora padrão |
| "USR_DIRIMP" | Diretório de impressão padrão |
| "USR_FILIAL" | Filial do sistema (Funcionário Vinculado, vinculo funcional) |
| "USR_CODFUNC" | Matrícula do Funcionário |
| "USR_GRPEMP" | Grupo de empresas (Funcionário Vinculado, vínculo funcional) |
