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

F290FORNP

User Function F290FORNP()

Controla a edição de fornecedor de destino e loja na primeira tela da FINA290.

F290FORNPFINA290
01 · VISÃO GERAL

Visão geral

A ficha histórica do TDN descreve o bloqueio dos campos “Gerar p/ Fornecedor” e “Loja”. .F. bloqueia a edição; .T. permite manipulação. As variáveis private cFornP e cLojaP são alteráveis no contexto padrão. (TOTVS, ref. 1) A listagem P12.2210 situa a chamada nas condições WHEN dos dois campos em FA290AUT, sem quarto argumento. A condição também depende de MV_PAR01 == 2; retornar .T. não elimina essa condição externa. (Ref. 2)

02 · SINTAXE

Sintaxe

User Function F290FORNP()

Parâmetros

cFornP
Private / CharacterContexto de execução

Fornecedor de destino, variável private alterável. (Ref. 1)

cLojaP
Private / CharacterContexto de execução

Loja de destino, variável private alterável. (Ref. 1)

Retorno

Lógico: .F. bloqueia os campos; .T. permite sua edição quando as demais condições da tela forem atendidas. (Ref. 1)

03 · EXEMPLO PRÁTICO

Bloquear edição sem trocar o fornecedor

#Include "Protheus.ch"

User Function F290FORNP()
    // Adaptação da finalidade e do retorno documentados pela TOTVS (ref. 1).
    // Executado pela condição WHEN dos campos; não gravar dados aqui.
    // Mantém os valores existentes de cFornP e cLojaP.
Return .F.
Resultado esperado

Propõe manter os valores atuais e bloquear a edição dos dois campos. Não define fornecedor, loja ou regra de faturamento. Exemplo não compilado nem executado em Protheus.

BOAS PRÁTICAS
  • Não declarar Local cFornP ou Local cLojaP para tentar alterar as private do chamador: isso cria variáveis diferentes no escopo local.
  • O exemplo oficial atribui valores às private e retorna .F.; valores fixos de fornecedor e loja exigem validação cadastral e regra própria. O exemplo editorial apenas bloqueia a edição.
  • WHEN pode ser reavaliado pela interface. Evitar mensagens repetidas, gravações ou integrações com efeito colateral.
  • A ficha histórica menciona Protheus 10/11 e Brasil. Isso não comprova compatibilidade automática com todo release atual.
  • 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. F290FORNP - Bloqueia dados. TDN. Consulta em 2026-10-23.
  2. EURAI. Pontos de Entrada P12.2210 - Parte 2. Universo do Desenvolvedor, 2023. 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