cKeyAliasCaractereObrigatório
Alias da tabela.
FUNçãOEm revisão
GetAdvFVal
GetAdvFVal(cKeyAlias,uCpo,[uChave],[nOrder],[uDef]) -> uRetPesquisa uma chave e devolve um ou vários campos.
Visão geral
cKeyAlias identifica a tabela e uCpo recebe nome de campo ou array de nomes. uChave e nOrder precisam corresponder ao índice real, incluindo filial e comprimentos do dicionário; uDef define retorno alternativo para chave ausente. O bloco ilustrativo recebe chave pronta e não pesquisa automaticamente; pressupõe SA1 disponível no ambiente correto. (Fontes: refs. 1–1.)
Sintaxe
GetAdvFVal(cKeyAlias,uCpo,[uChave],[nOrder],[uDef]) -> uRetParâmetros
uCpoCaractere ou arrayObrigatório
Campo ou lista de campos.
uChaveCaractereOpcional
Chave completa do índice.
nOrderNuméricoOpcional
Ordem do índice.
uDefQualquerOpcional
Retorno alternativo compatível.
Retorno
Valor de campo ou array de valores.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed463()
// Chave completa conforme SIX e SX3 do ambiente de teste.
Local bLookup := {|cKey| GetAdvFVal("SA1",{"A1_NOME","A1_TIPO"},cKey,1,{"",""})}
ConOut(ValType(bLookup))
Return NilResultado esperado
Prepara consulta de dois campos com array alternativo de duas posições. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Um retorno igual ao padrão não distingue chave ausente de valor legitimamente vazio. Validar existência separadamente se a regra precisar dessa distinção.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.