PARAMIXB[1]NuméricoObligatorio
Número de la línea de aCols que se está validando.
Predeterminado:PUNTO DE ENTRADAPublicado
MA261LIN
MA261LIN( <PARAMIXB> ) --> lRetValida cada línea de transferencia incluida en el browse de la rutina MATA261.
Descripción general
MA261LIN es un punto de entrada de la rutina Transferencias Modelo 2 (MATA261), ubicado al final de A261LinOk(). Permite ejecutar validaciones adicionales para cada línea de transferencia incluida en el browse. Cuando retorna .T., la línea se acepta; cuando retorna .F., la validación se rechaza hasta corregir el problema.
Sintaxis
MA261LIN( <PARAMIXB> ) --> lRetParámetros
Retorno
lRet, lógico. Retorna .T. para permitir la inclusión de la línea de transferencia. Retorna .F. para invalidar la línea e impedir continuar hasta corregir el problema.
Estructura mínima de MA261LIN
#Include "TOTVS.ch"
User Function MA261LIN()
Local lRet := .T.
Local nLinea := PARAMIXB[1] // Número de línea de aCols
// Validaciones adicionales del usuario.
// Ejemplo: verificar campos de nLinea antes de permitir la transferencia.
Return lRetResultado esperado
La función recibe la línea en validación mediante PARAMIXB[1], ejecuta reglas adicionales y retorna .T. para aceptar o .F. para rechazar la línea.
Ejemplo didáctico de rechazo controlado
#Include "TOTVS.ch"
User Function MA261LIN()
Local lRet := .T.
Local nLinea := PARAMIXB[1]
If Empty(nLinea)
MsgAlert("No fue posible identificar la línea de transferencia.", "Validación MATA261")
lRet := .F.
EndIf
Return lRetResultado esperado
El ejemplo muestra la lógica de retorno: cuando la regla identifica una inconsistencia, muestra un mensaje y retorna .F. para impedir la continuidad de la validación de la línea.
- Inicializa el retorno como .T. y cámbialo a .F. solamente cuando una regla de validación falle.
- Guarda PARAMIXB[1] en una variable local con nombre claro, como nLinea.
- Separa reglas grandes en funciones auxiliares para mantener el punto de entrada legible.
- Prueba inclusión, alteración y escenarios con múltiples líneas en MATA261 antes de liberar en producción.
- Registra en los comentarios de la personalización qué campo/posición de aCols se está validando.
- No persistas datos dentro de la validación si no es necesario; el objetivo principal es aprobar o rechazar la línea.
- No supongas que la posición de los campos en aCols será igual en todos los releases, personalizaciones o escenarios.
- Evita mensajes excesivos en validaciones por línea.
- Si la regla depende de campos específicos, documenta claramente qué posiciones/campos se consideraron.
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.