Tempo aproximado para leitura: 15 min

01. DADOS GERAIS

A função FwListBranches permite que rotinas dos módulos acessem o cadastro de Empresas / Filiais, em uma tela que permite a seleção de todas as filiais de uma empresa, permite exibir apenas as filiais do Grupo logado, permite fazer Pesquisa e Filtro, entre outras funcionalidades. Abaixo iremos detalhar a função.

02. EXEMPLOS DE USO

Exemplo 01 - Apresentar todas as empresas do grupo
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado.

Exemplo 02 - Botão de marcar todas as filiais da empresa
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado. Ao clicar sobre qualquer registro que seja da Empresa 01 e clicar em Marcar empresa/filiais, todas as Filiais dessa Empresa serão marcadas.

Exemplo 03 - Utilizando a Pesquisa
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado. Clique em Pesquisar, selecione a Chave de Pesquisa, então digite o texto a ser pesquisado e pressione [Enter] ou clique na Lupa.

Exemplo 04 - Utilizando Filtro
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado. Clique no botão Filtrar, crie o filtro e clique em Aplicar filtros selecionados.

Exemplo 05 - Marcar todas as Filiais / Desmarcar todas as Filiais
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado. Clique no botão Marcar todos para selecionar todas as Filiais. Clique no botão Desmarcar todos para remover a seleção de todas as Filiais.

Exemplo 06 - Marcar todas as Filiais utilizando Filtro
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.

Ao acessar a função FwListBranches() com os parâmetros acima, serão apresentadas as empresas, unidades de negócio e filiais do Grupo de Empresas que está logado. Clique no botão Filtrar, crie o filtro e clique em Aplicar filtros selecionados. Na tela com os registros filtrados, clique em Marcar todos. Com os registros marcados, selecione o botão Remover para retirar o filtro aplicado. Somente os registros que respeitam as opções do Filtro deverão continuar marcados.

Exemplo 07 - Apresentar somente as filiais da empresa logada
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .F.

Com a utilização do parâmetro lAllEmp = .F., a função FwListBranches() passa a reconhecer apenas as filiais da empresa que o usuário logou.

Exemplo 08 - Apresentar somente as filiais que o usuário possui acesso dentre todas as empresas do grupo
Parâmetros utilizados:
lCheckUser = .T.
lAllEmp = .T.

Utilizando os parâmetros lCheckUser e lAllEmp com .T., será verificada a listagem de todas as empresas do Grupo logado, porém será verificado também o cadastro do usuário logado, fazendo com que somente as filiais que ele possui acesso sejam listadas.

Exemplo 09 - Apresentar somente as filiais que o usuário possui acesso apenas na empresa logada
Parâmetros utilizados:
lCheckUser = .T.
lAllEmp = .F.

Utilizando os parâmetros lCheckUser=.T. e lAllEmp=.F., será verificada apenas a listagem das filiais da Empresa logada, e será verificado o cadastro do usuário logado, fazendo com que somente as filiais que ele possui acesso sejam listadas.

Exemplo 10 - Retorno da função selecionando registros
Parâmetros utilizados:
lCheckUser = .F.
lAllEmp = .T.
lOnlySelect = .F.
aRetInfo = { 'FLAG', 'SM0_CODFIL', 'SM0_CGC', 'SM0_NOMRED' }

Utilizando o parâmetro lCheckUser = .F. e o parâmetro lAllEmp = .T., não será verificado o cadastro do usuário, e serão listadas todas as empresas do Grupo. Com o parâmetro lOnlySelect = .F., mesmo selecionando alguns registros na listagem de filiais, ao clicar em Confirmar, o array de retorno trará informações de todos os registros que estavam listados.

Exemplo 11 - Retorno da função selecionando registros, retornando somente registros marcados
lCheckUser = .F.
lAllEmp = .T.
lOnlySelect= .T.
aRetInfo = { 'FLAG', 'SM0_CODFIL', 'SM0_CGC', 'SM0_NOMRED' }

Utilizando o parâmetro lCheckUser = .F. e o parâmetro lAllEmp = .T., não será verificado o cadastro do usuário, e serão listadas todas as empresas do Grupo. Com o parâmetro lOnlySelect = .T., ao clicar em Confirmar, o array de retorno irá trazer apenas informações dos registros selecionados.