aRotinaArray de registrosOpcional
Variável global disponibilizada pelo MenuDef. Recebe as opções adicionais do menu; não é um parâmetro formal de MTA103MNU.
PONTO DE ENTRADAEm revisão
MTA103MNU
User Function MTA103MNU()Inclui opções personalizadas no array aRotina do Documento de Entrada (MATA103).
Visão geral
MTA103MNU é executado em MenuDef, durante a montagem das opções da rotina Documento de Entrada. O ponto de entrada não recebe parâmetros formais: a personalização acrescenta itens ao array global aRotina, normalmente com AAdd(). A documentação oficial consultada cita Protheus 10 e 11; confirme a disponibilidade e a estrutura esperada pelo menu no release utilizado.
Sintaxe
User Function MTA103MNU()Parâmetros
Retorno
Não há retorno documentado. A personalização atua diretamente sobre o array global aRotina.
Adicionar uma opção ao Documento de Entrada
#Include "TOTVS.ch"
User Function MTA103MNU()
Local aNovaOpcao := { ;
"Consulta complementar", ;
"U_ConsultaEntrada", ;
0, ;
2, ;
0, ;
.F. ;
}
AAdd(aRotina, aNovaOpcao)
Return
User Function ConsultaEntrada()
MsgInfo("Consulta complementar do documento de entrada.", "MATA103")
ReturnResultado esperado
Ao montar o menu do MATA103, o Protheus acrescenta a opção “Consulta complementar”. Ao selecioná-la, executa U_ConsultaEntrada. Os valores numéricos e lógicos foram mantidos conforme o formato do exemplo histórico do TDN e devem ser validados no release em uso.
- Adicione somente as opções necessárias e mantenha cada ação vinculada a uma função existente e acessível no ambiente.
- Preserve os itens já montados pelo padrão; use AAdd() para acrescentar a nova opção ao final do array.
- A estrutura do item de menu pode variar conforme o release e o contexto da rotina. Confirme cada posição do array antes de publicar a customização.
- Teste inclusão, alteração, visualização, exclusão e demais opções do Documento de Entrada após instalar o ponto de entrada.
- A referência oficial consultada informa abrangência para Protheus 10 e 11. A presença e o contrato do ponto devem ser confirmados no fonte e na documentação do release atual.
- Uma ação escrita incorretamente ou uma função ausente pode criar uma opção de menu que falha somente quando o usuário a executa.
- Alterar ou recriar aRotina em vez de acrescentar um item pode remover opções padrão da rotina.
- Permissões de acesso e regras da rotina chamada continuam sendo responsabilidade da implementação personalizada.