PUNTO DE ENTRADAEn revisión

F241GAVE

User Function F241GAVE()

Recibe aVars directamente en PARAMIXB; ejemplo comunitario y diagnóstico editorial sin modificar elementos.

F241GAVEFINA241aVarsPARAMIXBExecBlock

01 · DESCRIPCIÓN GENERAL

Descripción general

Eurai Rapelli presenta una implementación que recibe PARAMIXB como array y lo devuelve sin cambios. (Rapelli, 2023, ref. 1) La llamada oficial pasa aVars directamente como cuarto argumento de ExecBlock; el índice específico sigue en construcción. (TOTVS, s.f., refs. 2–3) La lista P12.2210 sitúa la llamada en FA241BORDE y muestra el retorno clonado a aVars. (Universo do Desenvolvedor, 2023, ref. 4) El diagnóstico siguiente es código editorial propio basado en esa lectura y no reproduce íntegramente el fuente del artículo. La estructura interna del array y el contrato completo por release siguen sin confirmar.

02 · SINTAXIS

Sintaxis

User Function F241GAVE()

Parámetros

PARAMIXB / aVars

Array en ejemplo comunitario; estructura sin confirmarContexto por confirmar

El cuarto argumento de ExecBlock queda disponible directamente en PARAMIXB. La llamada pasa aVars, no {aVars}: PARAMIXB representa la colección completa y PARAMIXB[1] su primer elemento. (TOTVS, s.f., refs. 2 y 5) Nombres, tipos y significados de cada posición pendientes de confirmación.

Retorno

El fragmento del llamador pasa el resultado a AClone y sustituye aVars. Esto respalda la expectativa de array en ese flujo sin documentar cada posición. El ejemplo comunitario devuelve lo recibido. (refs. 1 y 4)

03 · EJEMPLO PRÁCTICO

Diagnóstico editorial que conserva la colección

#Include "Protheus.ch"

User Function F241GAVE()
    // Diagnóstico propio; referencia de contexto: Eurai Rapelli (ref. 1).
    // No presupone ni modifica posiciones de aVars.
    Local uContexto := PARAMIXB

    ConOut("F241GAVE: tipo recibido = " + ValType(uContexto))
    // Cuenta elementos solo cuando el valor recibido es un array.
    If ValType(uContexto) == "A"
        ConOut("F241GAVE: cantidad de elementos = " + AllTrim(Str(Len(uContexto))))
    EndIf

    // Devuelve lo recibido; no aplica una regla de filtro.
Return uContexto

Resultado esperado

Registra el tipo y, si es array, la cantidad de elementos; devuelve el mismo valor recibido. No lee ni modifica posiciones. Si el contexto no es array, el retorno tampoco lo será: el diagnóstico no corrige incompatibilidades con el llamador. Sin compilación ni ejecución en Protheus.

04 · EJEMPLO PRÁCTICO

Fragmento documental del llamador

// Lista comunitaria P12.2210: FINA241.PRX / FA241BORDE().
// Fragmento documental, no implementación ejecutable de F241GAVE.
aVars := AClone(ExecBlock("F241GAVE", .F., .F., aVars))

Resultado esperado

Muestra el retorno pasado a AClone antes de sustituir aVars. No muestra el contenido de las posiciones ni el resto de la rutina.

BUENAS PRÁCTICAS

No atribuya significado de campo, filtro, banco o fecha a una posición sin verificar el fuente y el contexto del release utilizado.
La ausencia de cambios es intencional: confirme la estructura recibida antes de desarrollar la regla de negocio.
No sustituya el retorno por .T., .F. o NIL como si el PE fuera una validación lógica.
En pruebas, compare la selección de títulos antes y después de personalizar y verifique tamaño, orden y tipos esperados del array.
No registre contenido de los elementos. El diagnóstico limita la salida al tipo y la cantidad.
Posición en la transacción, aliases, bloqueos y alcance entre releases sin confirmar. Las consultas en GitHub no localizaron una implementación útil.

Contenido relacionado

REFERENCIAS

Estado: En revisión
Página creada el: 23/10/2026 a las 08:38
Última revisión el: 23/10/2026 a las 09:17
Idioma original: Portugués
Revisión: Usina.BR