Histórico da Página

01. Visão Geral

...

O SmartX é a integração do framework POUI ao Protheus, permitindo que as rotinas sejam renderizadas em um browser moderno com componentes visuais mais ricos e responsivos. Com essa mudança, a forma como os Pontos de Entrada (PE's) aplicam filtros personalizados ao browse foi atualizada para se adequar ao novo modelo de interface.

Antes do SmartX, os filtros podiam ser escritos utilizando expressões ADVPL, com referências diretas aos campos via alias da tabela. Com o SmartX, esse formato não é mais suportado — o filtro deve obrigatoriamente ser escrito em Sintaxe SQL, iniciando com o Caractere @.

Comportamento Anterior X Novo Comportamento (SmartX)

...

...

• Filtros podiam utilizar expressões ADVPL com referências ao alias da tabela (ALIAS->NOME_CAMPO).
• Operadores lógicos ADVPL eram aceitos (.AND. / .OR.).
• Não havia exigência de sintaxe SQL nem do prefixo @.

Dica
icon false title Com SmartX (12.1.2610+)
O filtro deve ser escrito obrigatoriamente em sintaxe SQL pura, sem alias de tabela. A expressão de filtro deve iniciar com o caractere @. Operadores lógicos SQL devem ser utilizados (AND / OR). A regra se aplica somente a rotinas com Smart X Rotinas sem Smart X continuam aceitando Sintaxe ADVPL.

02. Ponto de Entrada - Filtros Personalizados do Browse

...

Os Pontos de Entrada responsáveis pela aplicação de filtros personalizados no browse tiveram seu comportamento alterado com a adoção do Smart X. O filtro retornado pelo PE deve seguir obrigatoriamente à sintaxe SQL.

Comportamento Anterior X Novo Comportamento (SmartX)

Referências e operadores não são suportados em rotinas Smart X.Expressão SQL pura, sem alias de tabela, iniciando obrigatoriamente com @. Operadores AND / OR em sintaxe SQL

Antes do SmartX	Com SmartX (12.1.2610+)
Os filtros podiam utilizar expressões ADVPL com referências
Nota
icon false title Expressão ADVPL - Incorreto
ao alias da tabela (ALIAS->NOME_CAMPO)
.	Os filtros devem ser escritos obrigatoriamente em sintaxe SQL pura, sem utilização de alias de tabela.
Operadores lógicos ADVPL eram aceitos (.AND. / .OR.
Dica
icon false title Expressão SQL - Correto
).	Devem ser utilizados operadores lógicos SQL (AND / OR).
Não havia exigência de sintaxe SQL nem da utilização do caractere @ no início da expressão.	A expressão de filtro deve iniciar obrigatoriamente com o caractere @.
A sintaxe ADVPL era aceita independentemente do tipo de rotina.	Em rotinas SmartX, a sintaxe ADVPL não é mais aceita para definição de filtros.

03. Exemplo de Utilização

...

Dica
icon false title Filtro Personalizado - SmartX (Correto)
A expressão retornada será: @ CT2_LOTE = '000001' AND CT2_SBLOTE = '001' — sintaxe SQL válida, iniciada com @utilização de sintaxe SQL pura, sem referências ADVPL e com operadores SQL, é a forma suportada em rotinas SmartX.

Bloco de código
language cpp theme Midnight title Expressão SQL - Correto (SmartX)
#INCLUDE 'TLPP-CORE.TH' User Function CTB400FIL() Local cFiltro As Character Local cLote As Character Local cSubLote As Character cLote := "000001" cSubLote := "001" // Filtro em sintaxe SQL - obrigatório iniciar com @ para rotinas SmartX. cFiltro := "@ CT2_LOTE = '" + cLote + "' AND CT2_SBLOTE = '" + cSubLote + "'" Return( cFiltro )

...