FWFldGet(): Como Obter o Valor de Campos do Modelo no Protheus via ADVPL
A função FWFldGet() permite acessar diretamente o conteúdo de um campo pertencente ao modelo de dados ativo no Protheus. Este recurso é bastante útil em situações que exigem leitura dinâmica de valores já carregados no modelo MVC.
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
|
1 |
FWFldGet(<cCampo>, [nLinha], [oModel], [lShowMsg]) -> xRet |
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:
|
1 |
Local cCodigoCliente := FWFldGet("A1_COD") |
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
|
1 2 3 4 5 6 7 8 9 10 |
FWFldGet(<cCampo>, [nLinha], [oModel], [lShowMsg]) -> xRet Parâmetros: cCampo - Nome do campo (caracteres) [obrigatório] nLinha - Linha no FORMGRID (opcional) oModel - Objeto do modelo, padrão FWMODELACTIVE() (opcional) lShowMsg - .T. ou .F. para exibir mensagem de erro (opcional) Retorna: Conteúdo do campo (xRet) |
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.
