cAliasCaractereObrigatório
Alias registrado no SX2 e disponível no contexto.
FUNçãOEm revisão
AXALTERA()
AxAltera( <cAlias>, <nReg>, <nOpc>, [aAcho], [aCpos], [nColMens], [cMensagem], [cTudoOk], [cTransact], [cFunc], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )Configura alteração de registros em interface legada.
Visão geral
AxAltera apresenta a interface de alteração de registros segundo o dicionário Protheus. O alias deve estar registrado no SX2, com campos e validações no SX3; o chamador fornece o contexto do registro e do browse. nOpc é a posição da opção em aRotina. Não confundir essa posição com o código de operação guardado na quarta coluna do menu: 4 neste exemplo. As listas opcionais diferem entre as funções Ax; não reutilize posições de AxAltera em AxInclui ou AxDeleta. A ficha não formaliza retorno. O fragmento apenas configura uma opção em uma rotina legada já preparada, sem executar a operação. (TOTVS, s.d., ref. 1) É necessário definir cCadastro como Private no chamador. cTudoOk é uma string com a função de validação, não um bloco.
Sintaxe
AxAltera( <cAlias>, <nReg>, <nOpc>, [aAcho], [aCpos], [nColMens], [cMensagem], [cTudoOk], [cTransact], [cFunc], [aButtons], [aParam], [aAuto], [lVirtual], [lMaximized] )Parâmetros
nRegNuméricoObrigatório
RecNo do registro no contexto do browse.
nOpcNuméricoObrigatório
Posição da opção em aRotina, não código universal da operação.
aAchoArrayOpcional
Campos exibidos; NOUSER pode impedir a inclusão de campos do usuário.
aCposArrayOpcional
Campos de edição; em AxDeleta, campos exibidos.
nColMensNuméricoOpcional
Não utilizado na ficha.
cMensagemCaractereOpcional
Não utilizado na ficha.
cTudoOkCaractereOpcional
Nome da função de validação, como string; não bloco.
cTransactCaractereOpcional
Função chamada dentro da transação de AxFunction.
cFuncCaractereOpcional
Função para carregar variáveis de memória.
aButtonsArrayOpcional
Botões adicionais: bitmap, bloco e título.
aParamArrayOpcional
Funções antes da tela, validação, dentro e fora da transação, nessa ordem.
aAutoArrayOpcional
Campos, valores e validações do modo automático; requer análise própria.
lVirtualLógicoOpcional
Arquivo virtual; a documentação o relaciona ao uso de cFunc.
lMaximizedLógicoOpcional
Maximização do diálogo.
Retorno
A ficha consultada não especifica um contrato de retorno; o exemplo não o utiliza.
Exemplo comentado
// Fragmento: aRotina ja existe no chamador legado.
// O framework fornece alias, registro e posicao da opcao.
AAdd(aRotina, {"Alteração", "AxAltera", 0, 4})Resultado esperado
Adiciona uma entrada de menu; não abre a tela nem altera dados isoladamente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Homologar em tabela própria de teste, com permissões e validações. Funções genéricas não substituem regras completas de rotinas de negócio ou um projeto MVC.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.