Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

DBSetIndex

DBSetIndex( cIndex ) --> Nil

Abre um índice existente sem criar suas chaves.

DBSetIndexAdvPL
01 · VISÃO GERAL

Visão geral

DBSetIndex acrescenta ordens do índice indicado às já abertas. Se havia ordens, não presume seleção automática da nova; se não havia, a primeira nova ordem assume controle. A função não cria o arquivo e não equivale a DBCreateIndex. ED_NEWIDX é apenas o nome de um índice próprio já existente e compatível com a EDTRB do exemplo, não um índice padrão do produto. 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)

02 · SINTAXE

Sintaxe

DBSetIndex( cIndex ) --> Nil

Parâmetros

cIndex
CaractereObrigatório

Nome de índice existente compatível com a tabela/RDD.

Retorno

Nil; não é um indicador lógico de sucesso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed338()
    // Requer ED_NEWIDX existente; nao cria nem substitui indice.
    If Select("EDTRB") > 0
        EDTRB->(DBSetIndex("ED_NEWIDX"))
    EndIf
Return Nil
Resultado esperado

Solicita abertura do índice; não afirma que ele ficou ativo quando já havia ordens. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • 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.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DBSetIndex. 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