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

F290VAL

User Function F290VAL()

Permite intervenir al seleccionar registros en la agrupación de títulos de FINA290.

F290VALFINA290
01 · DESCRIPCIÓN GENERAL

Descripción general

La ficha específica indica usar TRBSE2 para identificar el registro seleccionado y presenta ejemplos que localizan SE2 y cambian E2_HIST. Sus encabezados indican 12.1.2310 y 14/11/2023, sin certificar todos los releases. (TOTVS, ref. 1) La lista comunitaria pasa {aChaveLbn} en FA290BAVAL. (Ref. 2) El artículo de soporte describe un retorno con títulos seleccionados, mientras los ejemplos específicos terminan sin array y la llamada no asigna el retorno. Se conserva explícitamente esta divergencia, sin declarar confirmado un contrato de array. (Ref. 3)

02 · SINTAXIS

Sintaxis

User Function F290VAL()

Parámetros

PARAMIXB[1] / aChaveLbn
IndefinidoContexto por confirmar

La llamada envuelve aChaveLbn en un array externo; tipo y estructura interna sin confirmar. (Ref. 2)

Retorno

No concluyente entre las fuentes: los ejemplos específicos usan Return sin valor; el artículo agrupador menciona un array de títulos seleccionados. El diagnóstico editorial utiliza NIL sin prometer cambios en selección o importes. (Refs. 1–3)

03 · EJEMPLO PRÁCTICO

Inspeccionar el tipo del título seleccionado sin grabar

#Include "Protheus.ch"

User Function F290VAL()
    // Ejemplo editorial basado en el alias y campo del TDN (ref. 1).
    // No reproduce DbSeek con clave parcial ni cambia E2_HIST.
    If Select("TRBSE2") > 0
        If !TRBSE2->(Eof())
            // No registra número, proveedor ni importe del título.
            ConOut("F290VAL: tipo del titulo = " + TRBSE2->E2_TIPO)
        EndIf
    EndIf
Return Nil
Resultado esperado

Propone observar E2_TIPO en el registro temporal seleccionado. No modifica importes, histórico ni marcas. Ejemplo no compilado ni ejecutado en Protheus.

BUENAS PRÁCTICAS
  • No suponer que PARAMIXB completo sea una lista de títulos: la llamada comunitaria muestra un array externo con aChaveLbn, cuya estructura no está confirmada.
  • El segundo ejemplo oficial comenta un índice SE2 con proveedor y tienda, pero construye una clave de cinco campos. Verificar la clave completa y el éxito de DbSeek antes de grabar.
  • Los ejemplos oficiales cambian E2_HIST aunque el título de la ficha mencione valores. No demuestran una fórmula de importe ni actualización automática de totales.
  • Una futura adaptación de escritura debe validar el registro exacto, comprobar RecLock, conservar áreas y respetar la transacción estándar. El diagnóstico publicado no graba registros.
  • Plan editorial de pruebas: comparar el flujo estándar y la personalización en las operaciones descritas, comprobar los registros resultantes y registrar release y patch.
  • En revisión: fuentes y ejemplo comprobados documentalmente; código no compilado ni ejecutado en Protheus. Posición exacta en la transacción y comportamiento en el release utilizado sin confirmar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. F290VAL - Ponto de entrada para alteração de valores na seleção de registros - FINA290. TDN. Consulta el 2026-10-23.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta el 2026-10-23.
  3. TOTVS. FINA290 - Pontos de Entrada. Central de Atendimento, 2026. Consulta el 2026-10-23.
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