Manuais
PHC GO Como criar um filtro de dados
 
Umas das peças que compõem a Framework do PHC GO, é a peça Filtros de dados.

Esta peça da framework permite definir filtros para as entidades do PHC GO e é bastante utilizada quando queremos limitar o acesso a um conjunto de registos de uma determinada entidade mediante utilizador logado.

Ou seja, através desta peça, é possível definir filtros para entidades, que são aplicados automaticamente sem intervenção do utilizador e sempre que se consulta registos dessa entidade.

De modo a facilitar a leitura, começamos por documentar o ecrã Filtros de dados e os campos que o compõem ao detalhe, passando depois a cenários concretos, tudo isto para que possa tirar o máximo proveito da Framework do PHC GO.
 
 

Como introduzir um novo Filtro de dados


  1. Para criar um novo Filtro de dados no PHC GO, deve começar por navegar até ao ecrã Toolbox, localizado sobre o agrupador GO Studio ( Menu > PHC GO Studio > Toolbox ).

  2. Uma vez presente no ecrã Toolbox, carregue na opção Filtros de dados.

  3. Após o passo anterior, será exibida a lista de Filtros de dados introduzidos na sua instalação. Para adicionar uma novo, basta carregar em Introduza filtro de dados.

 

Quais os campos disponíveis no ecrã Filtros de dados


Nome: Campo utilizado para descrever o Filtro de dados. Deve utilizar um título que descreva sucintamente o intuito do filtro.

Entidade: Permite definir qual a entidade sobre a qual o filtro se irá aplicar.

Descrição: Descrição completa da peça.

Clausula WHERE do comando SQL: O conteúdo colocado neste campo será utilizado para juntar à cláusula WHERE dos comandos SQL usados na entidade definida no campo Entidade. Deve ser uma expressão em texto simples, na sintaxe de TSQL aceite pela base de dados Microsoft SQL até à versão 2014.
sticky_note_2Notas

Neste campo poderá utilizar variáveis internas para construir a cláusula WHERE desejada.
As variáveis internas devem ser implementadas entre chavetas.

Estão disponíveis os seguinte objetos: CurrentUser, Company e Parameters.

Exemplos: {CurrentUser.vendedor}, {Company.E1.Moeda}, {Parameters. ge_date_close_not_sa}

O objeto CurrentUser disponibiliza as informações do utilizador logado. Os campos disponíveis podem ser consultados no Dicionário de Dados do PHC GO ( menu Menu > Definições > Gestão de Dados > Dicionário de Dados > Entidade Utilizadores )

O objeto Company disponibiliza as informações dos Dados da Empresa, quando o objeto Parameters retorna os valores dos parâmetros da aplicação.

Clausula JOIN do comando SQL: O conteúdo deste campo será utilizado para juntar à cláusula join dos comandos SQL usados na entidade definida no campo Entidade. Deve ser uma expressão em texto simples, na sintaxe de TSQL aceite pela base de dados Microsoft SQL até á versão 2014.


Exemplo de aplicação de Filtros de dados


Com o objetivo de facilitar a leitura dos manuais, foi criado um tópico de manual para cada um dos exemplos fornecidos. Através dos seguintes links, selecione qual o exemplo que quer consultar:


 

PHC GO