Descrição da função FWFldGet()

Esta função retorna o valor de um campo de um modelo (Model) ativo no contexto de execução. Seu uso é ideal em rotinas que interagem com o dicionário de dados ou com interfaces construídas sobre o framework MVC do Protheus.

Sintaxe da função

Parâmetros

• cCampo (Caracteres) – Nome do campo a ser consultado. (Obrigatório)
• nLinha (Numérico) – Número da linha em grids do tipo FORMGRID. Se omitido, será usada a linha posicionada.
• oModel (Objeto) – Referência ao modelo de dados. Padrão: FWMODELACTIVE().
• lShowMsg (Lógico) – Define se será exibida mensagem de erro caso o campo não exista. Padrão: .T.

Retorno

Retorna xRet, que é o conteúdo do campo informado.

Exemplo de uso prático

Suponha que dentro de uma rotina MVC você deseje obter o valor do campo A1_COD de um modelo ativo:

Conteúdo Exclusivo!👇

Esse comando irá retornar o código do cliente carregado no modelo, conforme a linha e contexto atual da aplicação.

Código completo da documentação

Conclusão

A função FWFldGet() é extremamente útil para leitura de dados carregados no contexto do modelo MVC, permitindo maior controle e flexibilidade em personalizações e integrações com o Protheus. Seu uso correto evita acessos diretos desnecessários a banco de dados e melhora a performance e aderência à arquitetura da TOTVS.