Obtendo o Conteúdo de um ou mais Campos(SX3) com GetAdvFval em ADVPL

Tempo de leitura: 2 minutos

A função GetAdvFVal em ADVPL obtém obtém o conteúdo de um ou mais campos(SX3) informados nos parâmetros. Essa função é uma alternativa à função Posicione, com a diferença que pode retornar o conteúdo de um ou mais campos enquanto a função Posicione retorna o conteúdo de apenas um campo. Ela é uma das Funções da SX3(Campos das Tabelas) do TOTVS Protheus.

🚀 Quer evoluir no ADVPL de verdade?

Receba conteúdos práticos, códigos prontos e dicas que você 

 não aprende na documentação oficial

✔ Funções essenciais do ADVPL
✔ Exemplos reais usados no Protheus
✔ Dicas de debug e performance

🔐 Seu email está seguro. Sem spam.

Sintaxe:

GetAdvFVal(cAlias,uCpo,uChv,nOrd,uVal)

Parâmetro(s):

Retorno:

Exemplo da função GetAdvFVal em ADVPL:

#include 'protheus.ch'
#include 'rwmake.ch'
#INCLUDE "TBICONN.CH"
/*{Protheus.doc} User Function fGAdFVal
    (Essa função tem por finalidade mostrar a função GetAdvFVal em ADVPL)
    @type  Function
    @author Adilio Costa
    @since 08/10/2025
    @version 1.0

@?Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@?Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@?Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@?Conheça os Cursos e Formações do Protheus:
https://cursos-e-formacoes-protheusadvpl.gr-site.com/

@Participe de nossas comunidades no WhatsApp:
-Comunidade Protheus Backoffice:https://chat.whatsapp.com/KMUIAjwZ6EZ6eAHsLkPTyb
-Comunidade Protheus-RH:https://chat.whatsapp.com/L5dUyAna6xU4ylG5DUgfOW
-Comunidade Protheus-Programação:https://chat.whatsapp.com/LsD6z0apdqKHlOz67bcaEn
-Comunidade Protheus-Framework:https://chat.whatsapp.com/BzUFpjaSnTC3vtsfa77jmG

|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
/*/

#define Qlin Chr(13)+Chr(10) //Quebra de linha

User Function fGAdFVal()

Local cAlias :="SA2"
Local aCpos := {"A2_NOME","A2_END","A2_EST"}
Local aContCpo := {}
Local cCod  := "000001"
Local cLoja := "0001"
Local cChve  := ""
Local nOrd  := 1
Local aRetDef := {"","",""}
Local nI
Local cMsg := ""


PREPARE ENVIRONMENT EMPRESA '01' FILIAL '01'

cChve := FWxFilial("SA2")+cCod+cLoja

aContCpo := GetAdvFVal(cAlias,aCpos,cChve,nOrd,aRetDef)


For nI:= 1 To Len(aContCpo)
    cMsg += "O conteúdo do campo "+aCpos[nI]+" é:"+aContCpo[nI]+Qlin
Next nI

FWAlertInfo(cMsg,"Função GetAdvFVal")



Return


Podemos ver na imagem abaixo que a função GetAdvFVal retornou o conteúdo dos 3 campos passados como parâmetros:

Exemplo da função GetAdvFVal em ADVPL

🚀 Quer evoluir no ADVPL de verdade?

Receba conteúdos práticos, códigos prontos e dicas que você 

 não aprende na documentação oficial

✔ Funções essenciais do ADVPL
✔ Exemplos reais usados no Protheus
✔ Dicas de debug e performance

🔐 Seu email está seguro. Sem spam.

Bem, finalizamos mais um post aqui no Blog ProtheusAdvpl. Espero que tenha entendido, se tiver ficado alguma dúvida deixe seu comentário ou nos mande um e-mail para adiliocosta@protheusadvpl.com.br.

Grande abraço e fica com Deus.

 

Links de referência:

 

🚀 Quer dominar o Protheus de verdade?
Entre para o ProtheusAdvpl e receba conteúdos exclusivos sobre desenvolvimento, infraestrutura, módulos e carreira no Protheus

✔ Conteúdos organizados por categorias (Programação, Framework, Backoffice e RH)
✔ Dicas práticas usadas no dia a dia do Protheus
✔ Acesso a materiais, post e atualizações do Blog
🔐 Seu email está seguro. Sem spam. Só conteúdo profissional.