Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

AXCADASTRO()

AxCadastro( <cAlias>, <cTitulo>, [cVldExc], [cVldAlt] )

Abre manutenção genérica de um cadastro simples pelo dicionário.

AXCADASTRO()AdvPL
01 · VISÃO GERAL

Visão geral

AxCadastro oferece pesquisa, visualização, inclusão, alteração e exclusão para cadastros simples definidos no SX2/SX3. A ficha admite funções de validação de exclusão e alteração por nome; o exemplo mínimo omite ambas. O fonte comunitário de Scheron Martins chama AxCadastro para SA1, demonstrando a invocação, mas não prova adequação às regras de clientes de qualquer instalação. A proposta editorial usa somente o alias fictício ZZ1, previamente criado, aberto e homologado no dicionário, e define cCadastro/aRotina no contexto legado. Não é uma rotina pronta para cadastro padrão. (TOTVS, s.d., ref. 1; MARTINS, 2023, ref. 2)

02 · SINTAXE

Sintaxe

AxCadastro( <cAlias>, <cTitulo>, [cVldExc], [cVldAlt] )

Parâmetros

cAlias
CaractereObrigatório

Alias do SX2.

cTitulo
CaractereObrigatório

Título do cadastro.

cVldExc
CaractereOpcional

Nome da função de validação de exclusão.

cVldAlt
CaractereOpcional

Nome da função de validação de alteração.

Retorno

A ficha consultada não especifica um contrato de retorno; o exemplo não o utiliza.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function EdAxcadas()
    Private cCadastro := "Cadastro editorial de teste"
    Private aRotina := {}
    // ZZ1 deve existir no dicionario e estar aberta em homologacao.
    If Select("ZZ1") > 0
        AxCadastro("ZZ1", cCadastro)
    EndIf
Return Nil
Resultado esperado

Solicita manutenção interativa somente se ZZ1 já estiver aberta; sem essa preparação, não abre tela. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Restringir a tabela de homologação. Revisar autorização e regras antes de habilitar operações; não usar uma tela genérica para contornar regras do módulo.
  • 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. TOTVS. AXCADASTRO(). TDN. Consulta em 2026-10-26.
  2. MARTINS, Scheron. AxCadastro.prw, 22 set. 2023. Commit b12d5cb980785626e184454c968f41d5d954b932. Exemplo comunitário analisado, não reproduzido integralmente. Consulta em 2026-10-26.
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