PUNTO DE ENTRADAEn revisión

F290BTIT

User Function F290BTIT()

Define las columnas mostradas al seleccionar títulos para generar una factura por pagar.

F290BTITFINA290aCamposPARAMIXBACloneAAdd

01 · DESCRIPCIÓN GENERAL

Descripción general

TOTVS documenta F290BTIT para configurar las columnas de selección de títulos en FINA290. (Refs. 1–2) TDN describe aCampos como las columnas estándar y el retorno aCPO como las columnas a mostrar. La lista comunitaria sitúa la llamada en FA290AUT y asigna el resultado a aCampos. (Ref. 4) La ficha TDN es histórica, con alcance Protheus 10; el artículo de soporte relaciona el PE con FINA290 sin sustituir la validación del release y patch de destino. El fuente de Rodolfo Vacari, del 14/02/2018, en douglasbaciodilatte/bacio_di_latte clona PARAMIXB y enseguida asigna {} a la copia. Reconstruye la lista en vez de conservar el estándar. Añade marcado, prefijo, número, valor y dos entradas idénticas de E2_EMISSAO. Se observó la duplicación en el código, pero no se probó su efecto visual. El encabezado menciona FA290 y grabación del centro de costo; el cuerpo analizado solo monta y devuelve el array, sin instrucciones de grabación. Archivo leído completo en el commit referenciado; sin licencia de reproducción identificada, se analizó sin republicar íntegramente el fuente. (Ref. 5)

02 · SINTAXIS

Sintaxis

User Function F290BTIT()

Parámetros

PARAMIXB / aCampos

Array of RecordContexto de ejecución

Array de columnas estándar. La llamada pasa aCampos directamente, no {aCampos}; PARAMIXB representa esa lista, no un contenedor con la lista completa en su primer elemento. El ejemplo oficial usa AClone(PARAMIXB). (Refs. 1 y 3)

Retorno

Array con las columnas que se mostrarán. El ejemplo oficial devuelve aCPO y la lista comunitaria asigna el retorno a aCampos. (Refs. 1 y 4) Confirmar en el entorno de destino los detalles no descritos de la estructura antes de añadir campos.

03 · EJEMPLO PRÁCTICO

Base editorial para conservar las columnas estándar

#Include "Protheus.ch"

User Function F290BTIT()
    // Base editorial apoyada en el contrato TDN (ref. 1).
    // Conserva las columnas recibidas; esta base no añade campos.
    Local aColumnas := AClone(PARAMIXB)

Return aColumnas

Resultado esperado

Devuelve una copia de la lista recibida, conservando las definiciones de columnas. Punto de partida tras comprobar el contexto del release utilizado.

04 · EJEMPLO PRÁCTICO

Sustitución por cuatro columnas: adaptación del ejemplo oficial

#Include "Protheus.ch"

User Function F290BTIT()
    // Adaptación editorial del ejemplo TOTVS (ref. 1).
    // La lista comienza vacía porque se desea sustituir el conjunto estándar.
    // No se clona un array que se descartaría inmediatamente.
    Local aColumnas := {}

    // Se conserva la columna de marcado presente en el ejemplo oficial.
    AAdd(aColumnas, {"E2_OK", "", "  ", ""})
    AAdd(aColumnas, {"E2_PREFIXO", "", "Prefijo", "@!"})
    AAdd(aColumnas, {"E2_NUM", "", "Número", "@!"})
    AAdd(aColumnas, {"E2_VALOR", "", "Valor", "@E 999,999,999,999.99"})

Return aColumnas

Resultado esperado

Propone marcado, prefijo, número y valor según la selección del ejemplo oficial. Las demás columnas estándar no integran la lista devuelta; ejemplo aún no ejecutado en Protheus.

BUENAS PRÁCTICAS

Los dos ejemplos son alternativas; compile solo una implementación de F290BTIT.
Elegir explícitamente entre conservar la lista con AClone o reconstruirla desde {}. Clonar y después vaciar descarta la copia.
En el ejemplo oficial, cada definición tiene cuatro posiciones: campo, cadena vacía, título y expresión de formato. Es una observación del ejemplo; no se documentó aquí el significado completo de la segunda posición.
Conservar la columna de marcado en la adaptación y probar la selección de títulos. No confundir cambios de columnas con filtros de títulos elegibles.
Antes de añadir un campo, comprobar disponibilidad en el contexto de la pantalla, título, formato y columnas existentes. No repetir E2_EMISSAO sin una finalidad definida.
Plan editorial de pruebas: comparar pantalla estándar, lista conservada y lista sustituida; comprobar marcado, valores y generación de la factura. Registrar release y patch.
En revisión: fuentes y código analizados sin compilación ni ejecución en Protheus. Posición en la transacción sin confirmar.

Contenido relacionado

REFERENCIAS

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