aRotinaArray de registrosOpcional
Variável global montada pela 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 na função MenuDef da rotina Documento de Entrada, durante a montagem do array aRotina. O ponto de entrada não recebe parâmetros formais: a personalização atua sobre o array global aRotina, normalmente com AAdd(), para inserir novas opções de menu. A documentação oficial consultada no TDN cita abrangência para Microsiga Protheus 10 e 11; por isso, confirme a disponibilidade, o contrato e a estrutura esperada pelo menu no release utilizado.
Sintaxe
User Function MTA103MNU()Parâmetros
Programa fonteReferência TDNOpcional
MATA103.PRW — rotina Documento de Entrada.
Abrangência documentadaReferência históricaOpcional
Microsiga Protheus 10 e Microsiga Protheus 11, conforme página consultada no TDN.
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 seguem o formato apresentado na documentação histórica 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.
- Prefira criar uma função específica para a nova ação do menu e apontar o item de aRotina para essa função.
- Verifique permissões, contexto de filial, área aberta e tabelas necessárias antes de executar a nova rotina.
- 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.
- Usar uma descrição ambígua no menu dificulta suporte e auditoria, principalmente em ambientes com muitas customizações.
- 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.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.