Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

DbSetOrder e DbSeek em consultas simples

Alinha ordem ativa e chave antes da busca.

DbSetOrder e DbSeek em consultas simplesAdvPL
01 · VISÃO GERAL

Visão geral

A chave de DBSeek precisa corresponder à expressão da ordem selecionada. DBSetOrder seleciona por posição entre ordens abertas, não por número universal de índice. Zero usa ordem física; omitir ou informar número negativo não muda a ordem segundo a ficha. Trocar a ordem não reposiciona o registro. O fragmento exige nOrdem válido e cChave construído conforme o índice da tabela própria EDTRB, inclusive filial quando fizer parte da expressão. DBSeek com soft seek falso distingue correspondência exata de ausência; não ler campos sem confirmar retorno. (TOTVS, s.d., refs. 1–2)

03 · EXEMPLO PRÁTICO

Exemplo comentado

// Fragmento: nOrdem e cChave validados no contrato do chamador.
If Select("EDTRB") > 0
    EDTRB->(DBSetOrder(nOrdem))
    If EDTRB->(DBSeek(cChave, .F.))
        ConOut("Chave encontrada")
    Else
        ConOut("Chave ausente")
    EndIf
EndIf
Resultado esperado

Mensagem de presença ou ausência da chave; nenhum registro alterado explicitamente. Ordem e posição do alias são alteradas. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Não confundir retorno lógico com posição válida após uma busca malsucedida. Preservar contexto conforme o chamador; navegação pode efetivar alterações pendentes.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DBSetOrder. TDN. Consulta em 2026-10-26.
  2. TOTVS. DBSeek. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha