Histórico da Página

...

Nota

title	SmartX - 12.1.2610

A partir da release 12.1.2610, a rotina passa a permitir a visualização do browser utilizando o Smart X SmartX.

Com essa alteração, a implementação de Pontos de Entrada (PE) relacionados à inclusão de opções de menu passa a ter um novo comportamento, especialmente no que se refere à forma como as ações são exibidas na interface.

Aviso

title	Fase de testes

Funcionalidade disponível a partir da release 12.1.2610.

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) customizam o menu de ações das rotinas foi atualizada para se adequar ao novo modelo de interface.

...

Aviso

title	Antes do SmartX

Opções adicionadas via PE apareciam exclusivamente no menu de ações da rotina (dropdown), sem possibilidade de destaque visual diferenciado.
Não havia distinção visual entre uma ação principal e uma ação secundária — todos os itens recebiam o mesmo tratamento visual.
Em rotinas não-MVC, o array de retorno do PE utilizava posições fixas para configurar cada propriedade do item de menu.
Rotinas MVC utilizavam o comando ADD OPTION, porém sem suporte ao parâmetro PAGEACTION.

Dica

title	Com SmartX (12.1.2610+)

Opções podem ser exibidas como Page Actions — botões de destaque visíveis diretamente no browse, fora do menu dropdown, facilitando o acesso às ações mais utilizadas pelo usuário.
A distinção entre ação de destaque e ação secundária é feita pelo parâmetro PAGEACTION, presente na definição de cada item do menu.
Rotinas MVC utilizam a flag PAGEACTION diretamente ao final da instrução ADD OPTION.
Rotinas não-MVC utilizam a 10ª posição do array de retorno com valor .T. para indicar que o item é uma PageAction.

02. Ponto de Entrada - Inclusão de Opções no Menu da Rotina.

Os Pontos de Entrada responsáveis pela inclusão de novas opções no menu das rotinas tiveram seu comportamento alterado com a adoção do SmartX. O novo padrão diferencia rotinas do tipo MVC e Não-MVC, cada uma com sua própria sintaxe e parâmetros.

...

Bloco de código

language	cpp
theme	Midnight
title	Exemplo de PE - Não MVC

#INCLUDE 'TLPP-CORE.TH'
#INCLUDE 'FWMVCDEF.CH'  

User Function CT240BUT()

    Local aNovoItemMenu As Array
    Local lPageAction   As Logical

    aNovoItemMenu := {}
    lPageAction   := .T. // Indica que o Botão Será Adicionado ao PageAction do Browse da Rotina.

    // Opção no Menu - Ações de Registro.
    aAdd( aNovoItemMenu, { 'Teste SmartX - Page Action', 'Alert( "Teste SmartX" )', 0, 9,,,,,, lPageAction } )

    // Opção Exibida Diretamente no Browse da Rotina.
    aAdd( aNovoItemMenu, { 'Teste SmartX', 'Alert( "Teste SmartX" )'			  , 0, 7 				   } )

Return( aNovoItemMenu )

03. Browse da Rotina.

...

Árvore de páginas

Versões comparadas

Versão antiga 27

Nova versão 28

Chave

01. Visão Geral.

02. Ponto de Entrada - Inclusão de Opções no Menu da Rotina.

03. Browse da Rotina.