Usina BRAdvPL Guia
Entrar
← Todos os tópicos
COMANDOEm revisão

NEW MODEL em AdvPL

NEW MODEL TYPE nType DESCRIPTION cDescription BROWSE oBrowse SOURCE cSource [MODELID cModelID] MASTER cMasterAlias

Gera a estrutura MVC por diretiva de pré-compilação.

NEW MODEL em AdvPLAdvPL
01 · VISÃO GERAL

Visão geral

Na cópia pública de FWMVCDef.ch consultada, NEW MODEL é um #xcommand que expande browse, ModelDef, ViewDef e, em uma variante, MenuDef. TYPE 1 representa uma entidade; os tipos 2/3 exigem relacionamento. O exemplo usa apenas uma tabela fictícia ZZ1 e não deve ser combinado com definições manuais duplicadas das funções geradas. A cópia do GitHub é uma referência para análise, não uma distribuição oficial ou prova de compatibilidade com a LIB atual. (Fontes: refs. 1–3.)

02 · SINTAXE

Sintaxe

NEW MODEL TYPE nType DESCRIPTION cDescription BROWSE oBrowse SOURCE cSource [MODELID cModelID] MASTER cMasterAlias

Parâmetros

TYPE
NuméricoObrigatório

1 para exemplo de uma entidade.

DESCRIPTION
CaractereObrigatório

Título descritivo.

BROWSE
ObjetoObrigatório

Variável que recebe o browse gerado.

SOURCE
CaractereObrigatório

Nome base da rotina.

MODELID
CaractereOpcional

ID do modelo, distinto da User Function.

MASTER
CaractereObrigatório

Alias cadastrado no dicionário.

Retorno

Comando de pré-compilação; não é uma função de retorno único.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
#Include "FWMVCDef.ch"

User Function Ed557()
    Local oLista
    // Exige ZZ1 em SX2/SX3 e homologacao dos acessos gerados.
    NEW MODEL ;
        TYPE 1 ;
        DESCRIPTION "Cadastro de teste" ;
        BROWSE oLista ;
        SOURCE "ED557" ;
        MODELID "ED557M" ;
        MASTER "ZZ1"
// O proprio comando expande Return e funcoes Static MVC.
Resultado esperado

Quando compilada e chamada em ambiente preparado, a rotina abre o browse gerado; não foi executada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir o include entregue com a LIB; não substituí-lo pela cópia pública. Preparar SX2/SX3 e acessos da tabela fictícia antes de homologar. Inspecionar o fonte pré-compilado e evitar duplicação de ModelDef/ViewDef/MenuDef no mesmo PRW.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. imsys/Protheus-Include. Cópia pública de fwmvcdef.ch; arquivo lido integralmente, commit 7b56abf. Consulta em 2026-10-27.
  2. TOTVS. MPFormModel. TDN. Consulta em 2026-10-27.
  3. TOTVS. FWFormView. TDN. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha