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 la función MenuDef de la rutina Documento de Entrada mientras se construye el array aRotina. No recibe parámetros formales: la personalización actúa sobre el array global aRotina, normalmente con AAdd(), para insertar nuevas opciones de menú. La página oficial consultada en TDN menciona Microsiga Protheus 10 y 11; confirme la disponibilidad, el contrato y la estructura esperada del menú en la versión utilizada.

02 · SINTAXIS

Sintaxis

User Function MTA103MNU()

Parámetros

aRotina
Array de registrosOpcional

Variable global construida por MenuDef. Recibe las opciones adicionales del menú y no es un parámetro formal de MTA103MNU.

Programa fuente
Referencia TDNOpcional

MATA103.PRW — rutina Documento de Entrada.

Alcance documentado
Referencia históricaOpcional

Microsiga Protheus 10 y Microsiga Protheus 11, conforme a la página consultada en TDN.

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. Los valores numéricos y lógicos siguen el formato presentado en la documentación histórica de TDN y deben validarse en la versión utilizada.

BUENAS PRÁCTICAS
  • Agregue solamente las opciones necesarias y vincule cada acción con una función disponible.
  • Conserve los elementos estándar y utilice AAdd() para agregar la nueva opción.
  • Prefiera crear una función específica para la nueva acción del menú y apuntar el item de aRotina a esa función.
  • Verifique permisos, contexto de sucursal, áreas abiertas y tablas necesarias antes de ejecutar la nueva rutina.
  • La estructura puede variar según la versión y el contexto; confirme cada posición del array.
  • Pruebe todas las operaciones de Documento de Entrada después de instalar el punto.
ERRORES COMUNES
  • La referencia oficial indica Protheus 10 y 11. Confirme 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.
  • Una descripción ambigua en el menú dificulta soporte y auditoría, especialmente en ambientes con muchas personalizaciones.
  • 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
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha