Usina BRAdvPL Guia
Entrar
← Todos os tópicos
PONTO DE ENTRADAEm revisão

F290VAL

User Function F290VAL()

Permite intervenção ao selecionar registros na aglutinação de títulos da FINA290.

F290VALFINA290
01 · VISÃO GERAL

Visão geral

A ficha específica orienta usar TRBSE2 para identificar o registro selecionado e apresenta exemplos que localizam SE2 e alteram E2_HIST. Os exemplos possuem cabeçalho 12.1.2310, de 14/11/2023; isso não certifica todo release. (TOTVS, ref. 1) A lista comunitária mostra {aChaveLbn} em FA290BAVAL. (Ref. 2) O artigo de suporte descreve retorno com títulos marcados, enquanto os exemplos específicos terminam sem array e o trecho de chamada não atribui retorno. Essa divergência permanece explícita; não se publica um contrato de array como comprovado. (Ref. 3)

02 · SINTAXE

Sintaxe

User Function F290VAL()

Parâmetros

PARAMIXB[1] / aChaveLbn
IndefinidoContexto a confirmar

A chamada envolve aChaveLbn em array externo; tipo e estrutura interna não confirmados. (Ref. 2)

Retorno

Tratamento não conclusivo entre as fontes: os exemplos da ficha específica usam Return sem valor; o artigo agrupador menciona array de títulos marcados. O exemplo editorial usa NIL apenas como diagnóstico, sem prometer alteração de seleção ou valores. (Refs. 1–3)

03 · EXEMPLO PRÁTICO

Inspecionar o tipo do título selecionado sem gravar

#Include "Protheus.ch"

User Function F290VAL()
    // Exemplo editorial baseado no alias e campo do TDN (ref. 1).
    // Não reproduz DbSeek com chave parcial nem altera E2_HIST.
    If Select("TRBSE2") > 0
        If !TRBSE2->(Eof())
            // Não registra número, fornecedor ou valor do título.
            ConOut("F290VAL: tipo do titulo = " + TRBSE2->E2_TIPO)
        EndIf
    EndIf
Return Nil
Resultado esperado

Propõe observar E2_TIPO no registro temporário selecionado. Não altera valores, histórico ou marcações. Exemplo não compilado nem executado em Protheus.

BOAS PRÁTICAS
  • Não presumir que PARAMIXB inteiro seja uma relação de títulos: a chamada comunitária mostra um array externo com aChaveLbn, cujo layout não foi confirmado.
  • No segundo exemplo oficial, o comentário do índice SE2 inclui fornecedor e loja, mas a chave montada usa apenas cinco campos. Conferir a chave completa e o sucesso de DbSeek antes de qualquer gravação.
  • Os exemplos oficiais alteram E2_HIST apesar do título da documentação mencionar valores. Não deduzir deles uma fórmula de valor ou atualização automática de totais.
  • Uma futura adaptação de escrita deve validar o registro exato, testar RecLock, preservar áreas de trabalho e respeitar a transação do padrão. O diagnóstico publicado não escreve.
  • Roteiro editorial de homologação: comparar o fluxo padrão e a customização nas operações descritas, conferir os registros resultantes e registrar release e patch.
  • Em revisão: fontes e exemplo conferidos documentalmente; código não compilado nem executado em Protheus. Posição exata na transação e comportamento no release-alvo não confirmados.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. F290VAL - Ponto de entrada para alteração de valores na seleção de registros - FINA290. TDN. Consulta em 2026-10-23.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. Consulta em 2026-10-23.
  3. TOTVS. FINA290 - Pontos de Entrada. Central de Atendimento, 2026. Consulta em 2026-10-23.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha