PONTO DE ENTRADAEm revisão

F290BTIT

User Function F290BTIT()

Define as colunas exibidas na seleção de títulos para gerar uma fatura a pagar.

F290BTITFINA290aCamposPARAMIXBACloneAAdd

01 · VISÃO GERAL

Visão geral

A TOTVS documenta F290BTIT para configurar as colunas da seleção de títulos da FINA290. (Refs. 1–2) O TDN descreve aCampos como as colunas padrão e o retorno aCPO como as colunas a apresentar. A listagem comunitária situa a chamada em FA290AUT, com atribuição a aCampos. (Ref. 4) A ficha TDN é histórica, com abrangência Protheus 10; o artigo de suporte relaciona o PE à FINA290, sem substituir a validação no release e patch de destino. O fonte de Rodolfo Vacari, de 14/02/2018, no repositório douglasbaciodilatte/bacio_di_latte clona PARAMIXB e logo atribui {} à cópia. Assim, reconstrói a lista em vez de preservar o padrão. Adiciona marcação, prefixo, número, valor e duas entradas idênticas de E2_EMISSAO. A duplicação foi observada no código, mas seu efeito visual não foi testado. O cabeçalho menciona FA290 e gravação de centro de custo; o corpo analisado apenas monta e retorna o array, sem instrução de gravação. Fonte lido integralmente no commit referenciado; sem licença de reprodução identificada, foi analisado sem republicação integral. (Ref. 5)

02 · SINTAXE

Sintaxe

User Function F290BTIT()

Parâmetros

PARAMIXB / aCampos

Array of RecordContexto de execução

Array das colunas padrão. A chamada passa aCampos diretamente, sem {aCampos}; PARAMIXB representa essa lista, e não um invólucro cujo primeiro elemento contenha a lista inteira. O exemplo oficial usa AClone(PARAMIXB). (Refs. 1 e 3)

Retorno

Array com as colunas que serão exibidas. O exemplo oficial devolve aCPO e a listagem comunitária atribui o retorno a aCampos. (Refs. 1 e 4) Confirme no ambiente de destino os detalhes não descritos da estrutura antes de acrescentar campos.

03 · EXEMPLO PRÁTICO

Base editorial para preservar as colunas padrão

#Include "Protheus.ch"

User Function F290BTIT()
    // Base editorial apoiada no contrato do TDN (ref. 1).
    // Mantém as colunas recebidas; esta base ainda não acrescenta campos.
    Local aColunas := AClone(PARAMIXB)

Return aColunas

Resultado esperado

Retorna uma cópia da lista recebida, mantendo a definição das colunas. Serve como ponto de partida após conferir o contexto no release utilizado.

04 · EXEMPLO PRÁTICO

Substituição por quatro colunas: adaptação do exemplo oficial

#Include "Protheus.ch"

User Function F290BTIT()
    // Adaptação editorial do exemplo TOTVS (ref. 1).
    // A lista começa vazia porque o objetivo é substituir o conjunto padrão.
    // Não clonamos um array que seria descartado logo em seguida.
    Local aColunas := {}

    // Mantemos a coluna de marcação presente no exemplo oficial.
    AAdd(aColunas, {"E2_OK", "", "  ", ""})
    AAdd(aColunas, {"E2_PREFIXO", "", "Prefixo", "@!"})
    AAdd(aColunas, {"E2_NUM", "", "Número", "@!"})
    AAdd(aColunas, {"E2_VALOR", "", "Valor", "@E 999,999,999,999.99"})

Return aColunas

Resultado esperado

Propõe marcação, prefixo, número e valor, conforme a seleção do exemplo oficial. As demais colunas padrão deixam de compor a lista devolvida; exemplo ainda não executado em Protheus.

BOAS PRÁTICAS

Os dois exemplos são alternativas; compile apenas uma implementação de F290BTIT.
Escolher explicitamente entre preservar a lista com AClone e reconstruí-la a partir de {}. Clonar e depois zerar descarta a cópia.
No exemplo oficial, cada definição tem quatro posições: campo, string vazia, título e expressão de formatação. Isso é uma observação do exemplo; a semântica completa da segunda posição não foi documentada nesta pesquisa.
Conservar a coluna de marcação na adaptação e testar a seleção dos títulos. Não confundir alteração de colunas com filtragem dos títulos elegíveis.
Antes de adicionar um campo, conferir disponibilidade no contexto da tela, título, formatação e eventuais colunas já existentes. Não repetir E2_EMISSAO sem uma finalidade definida.
Roteiro editorial de homologação: comparar tela padrão, lista preservada e lista substituída; verificar marcação, valores e geração da fatura. Registrar release e patch.
Em revisão: fontes e código analisados, sem compilação ou execução em Protheus. Não foi confirmada a posição na transação.

Conteúdos relacionados

REFERÊNCIAS

Situação: Em revisão
Página criada em: 23/10/2026 às 14:08
Última revisão em: 23/10/2026 às 15:18
Idioma original: Português
Revisão: Usina.BR