Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

GetAdvFVal

GetAdvFVal(cKeyAlias,uCpo,[uChave],[nOrder],[uDef]) -> uRet

Busca una clave y devuelve uno o varios campos.

GetAdvFValAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

cKeyAlias identifica tabla y uCpo recibe campo o array de nombres. uChave y nOrder deben corresponder al índice real, incluyendo filial y longitudes; uDef aporta retorno alternativo para clave ausente. Bloque recibe clave lista sin consultar automáticamente; presupone SA1 disponible en ambiente correcto. (Fuentes: refs. 1–1.)

02 · SINTAXIS

Sintaxis

GetAdvFVal(cKeyAlias,uCpo,[uChave],[nOrder],[uDef]) -> uRet

Parámetros

cKeyAlias
CarácterObligatorio

Alias de tabla.

uCpo
Carácter o arrayObligatorio

Campo o lista de campos.

uChave
CarácterOpcional

Clave completa de índice.

nOrder
NuméricoOpcional

Orden de índice.

uDef
CualquieraOpcional

Retorno alternativo compatible.

Retorno

Valor de campo o array de valores.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed463()
    // Clave completa segun SIX y SX3 del ambiente de prueba.
    Local bLookup := {|cKey| GetAdvFVal("SA1",{"A1_NOME","A1_TIPO"},cKey,1,{"",""})}
    ConOut(ValType(bLookup))
Return Nil
Resultado esperado

Prepara consulta de dos campos con array alternativo de dos posiciones. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Retorno igual al defecto no distingue clave ausente de valor legítimamente vacío. Validar existencia por separado si importa esa distinción.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. GetAdvFVal. TDN. Consulta el 2026-10-27.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha