Linha Microsiga Protheus

Árvore de páginas

01. DADOS GERAIS

Produto:

TOTVS Backoffice

Linha de Produto:

Linha Protheus

Segmento:

Serviços

Módulo:

TOTVS Backoffice (Linha Protheus) - Ativo Fixo (SIGAATF)

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

Importante!

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
Manipulação de PE no sistema
Default lAF020Brw := ExistBlock("AF020BRW")
If lAF020Brw
	cFilEsp := ExecBlock( "AF020BRW", .F., .F. )
	cFilPad := IIF(ValType(cFilEsp) == "C", cFilEsp, cFilPad )
EndIf
Exemplo de PE
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


Importante !!

  • 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

  • Não se aplica.