01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Função:ATFA020
País:Brasil
Ticket:Interno
Requisito/Story/IssueDSERCTR1-46030

02. DESCRIÇÃO

O ponto de entrada AF020BRW é utilizado para aplicar um filtro personalizado antes da execução do browse na tabela SN5 durante a rotina de atualização de valores contábeis. Ele permite ao desenvolvedor especificar um filtro especial que será utilizado para restringir os registros visualizados no browse, adaptando a busca de acordo com as necessidades específicas do usuário.

Esse ponto de entrada é especialmente útil quando há necessidade de realizar operações específicas antes de listar os registros no browse, como aplicar filtros adicionais que não são contemplados pela rotina padrão.

03. DEMAIS INFORMAÇÕES

A partir da release 12.1.2610, as rotinas compatíveis com SmartX passam a utilizar uma nova camada de renderização e gerenciamento de interface, baseada na integração entre o framework PO UI e o Protheus.

Com essa evolução, alguns Pontos de Entrada (PE) passam a possuir comportamentos específicos quando executados em rotinas SmartX

Mudança no comportamento dos Filtros Personalizados no Browse em rotinas SmartX

Devido à nova arquitetura utilizada pelo SmartX, a implementação de determinados Pontos de Entrada relacionados à Filtros Personalizados no Browse das rotinas também sofreu alterações.

Dessa forma, para que as customizações funcionem corretamente em ambientes SmartX, é necessário seguir o novo padrão de implementação descrito na documentação disponibilizada no link abaixo.

⚠️ Importante:

  • As alterações descritas nesta documentação aplicam-se exclusivamente às rotinas executadas em SmartX;
  • Rotinas que não utilizam SmartX continuam mantendo o comportamento original dos Pontos de Entrada, sem necessidade de adequações;
  • Recomenda-se a revisão das customizações existentes para garantir compatibilidade com a nova estrutura.

📌 Consulte a documentação oficial para detalhes sobre a nova forma de implementação dos Pontos de Entrada em SmartX.


Mudança no comportamento dos PE's de Filtros Personalizados do Browse em Rotinas SmartX
Default lAF020Brw := ExistBlock("AF020BRW")
If lAF020Brw
	cFilEsp := ExecBlock( "AF020BRW", .F., .F. )
	cFilPad := IIF(ValType(cFilEsp) == "C", cFilEsp, cFilPad )
EndIf
User Function AF020BRW()
    // Retorna um filtro personalizado para a execução do browse
    Local cFiltroEspecial := "SN5->CAMPO = 'VALOR_DESEJADO'"
    
      // Implementa a lógica do filtro e retorna o valor
Return cFiltroEspecial


  • Observa-se que a utilização do PE e os impactos dele no sistema são de responsabilidade do cliente.
  • Os exemplos utilizados nessa documentação são apenas para fins de demonstração, cada cliente deve verificar qual comportamento deseja realizar de acordo com o escopo do ponto de entrada.

04. ASSUNTOS RELACIONADOS