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

Ordens, índices e expressões de chave

IndexKey([nOrdem]) -> cKey

Confere a expressão do índice antes de montar uma busca.

Ordens, índices e expressões de chaveAdvPL
01 · VISÃO GERAL

Visão geral

A ordem ativa determina a sequência lógica e a expressão usada em DbSeek/MsSeek; não é um número universal entre ambientes. IndexKey() devolve a expressão corrente como texto; uma ordem inexistente devolve string vazia, mas área fechada também pode gerar erro. A chave montada precisa respeitar ordem dos componentes, tipos e larguras. Índice físico do SGBD, ordem do RDD e chave de negócio são conceitos relacionados, mas não intercambiáveis. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

IndexKey([nOrdem]) -> cKey
03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed563()
    // Exige area aberta com indices; bloco nao invocado.
    Local bInspecionar := {|| IndexKey()}
    ConOut(ValType(bInspecionar))
Return Nil
Resultado esperado

Imprime B. Ao avaliar no contexto real, o resultado é a expressão da ordem corrente. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Consultar SIX/expressão efetiva, restaurar a ordem do chamador e verificar campos após buscas. Mudança de ordem não reordena um array nem cria automaticamente um índice físico novo.
  • 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. IndexKey. TDN. Consulta em 2026-10-27.
  2. TOTVS. MsSeek. TDN. Consulta em 2026-10-27.
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