Usina BRGuía AdvPL
Ingresar
← Todos los temas
PUNTO DE ENTRADAEn revisión

MTA103MNU

User Function MTA103MNU()

Agrega opciones personalizadas al array de menú aRotina del Documento de Entrada MATA103.

Puntos de entradaComprasDocumento de entradaMATA103Menú
01 · DESCRIPCIÓN GENERAL

Descripción general

MTA103MNU se ejecuta en MenuDef mientras se construye el menú de Documento de Entrada. No recibe parámetros formales: la personalización agrega elementos al array global aRotina, normalmente con AAdd(). La página oficial consultada menciona Protheus 10 y 11; confirma la disponibilidad y la estructura esperada en la versión utilizada.

02 · SINTAXIS

Sintaxis

User Function MTA103MNU()

Parámetros

aRotina
Array de registrosOpcional

Variable global expuesta por MenuDef. Recibe las opciones adicionales y no es un parámetro formal de MTA103MNU.

Retorno

No hay retorno documentado. La personalización modifica directamente el array global aRotina.

03 · EJEMPLO PRÁCTICO

Agregar una opción al Documento de Entrada

#Include "TOTVS.ch"

User Function MTA103MNU()
    Local aNuevaOpcion := { ;
        "Consulta complementaria", ;
        "U_ConsultaEntrada", ;
        0, ;
        2, ;
        0, ;
        .F. ;
    }

    AAdd(aRotina, aNuevaOpcion)
Return

User Function ConsultaEntrada()
    MsgInfo("Consulta complementaria del documento de entrada.", "MATA103")
Return
Resultado esperado

Al construir el menú de MATA103, Protheus agrega “Consulta complementaria” y ejecuta U_ConsultaEntrada al seleccionarla. Valida las posiciones históricas del array en la versión utilizada.

BUENAS PRÁCTICAS
  • Agrega solamente las opciones necesarias y vincula cada acción con una función disponible.
  • Conserva los elementos estándar y utiliza AAdd() para agregar la nueva opción.
  • La estructura puede variar según la versión y el contexto; confirma cada posición del array.
  • Prueba todas las operaciones de Documento de Entrada después de instalar el punto.
ERRORES COMUNES
  • La referencia oficial indica Protheus 10 y 11. Confirma el punto y su contrato en el fuente y la documentación de la versión actual.
  • Una acción incorrecta o una función ausente puede fallar solamente cuando el usuario selecciona la opción.
  • Reemplazar aRotina en lugar de agregar un elemento puede eliminar opciones estándar.
  • Los permisos y reglas de negocio siguen bajo responsabilidad de la rutina personalizada.

Contenido relacionado

REFERENCIAS
  1. TOTVS. MTA103MNU — Agregar opciones al array aRotina. Documentación histórica del TDN para Protheus 10 y 11.
  2. TOTVS. Puntos de entrada disponibles en Documento de Entrada (MATA103). TDN, última modificación indicada el 23 oct. 2024.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR