cApelidoCaractereObrigatório
Apelido já registrado na área.
FUNçãOEm revisão
DBOrderNickname
DBOrderNickname( cApelido ) --> lRetSeleciona uma ordem pelo apelido registrado.
Visão geral
O apelido precisa ter sido associado à ordem por DBSetNickname. Não é o nome de um campo nem um apelido universal do Protheus. A referência descreve retorno lógico e mensagem de erro se o apelido não existir; falso não deve ser tratado como falha silenciosa garantida. O fragmento pressupõe cApelido definido pelo chamador e uma ordem previamente registrada na EDTRB. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)
Sintaxe
DBOrderNickname( cApelido ) --> lRetParâmetros
Retorno
Lógico: verdadeiro se a seleção for realizada; apelido ausente pode emitir erro.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed335()
// Fragmento: cApelido vem do contrato do chamador.
If Select("EDTRB") > 0
ConOut(cValToChar(EDTRB->(DBOrderNickname(cApelido))))
EndIf
Return NilResultado esperado
Seleção da ordem existente; exige o contexto descrito, não é exemplo autossuficiente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
- 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.