Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

DbCreateIndex

DBCreateIndex( <cName>, <cExprKey>, [bExprKey], [lUnique] ) --> Nil

Crea índice para tabla o vista del contexto.

DbCreateIndexAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

DBCreateIndex recibe nombre y expresión, con bloque/unicidad opcionales. Puede sustituir índice de mismo nombre, cerrar índices y cambiar orden/posición. Bloque debe reflejar valor de clave, no texto de expresión. Archivo comunitario devuelve cIndice en bloque; no se reproduce como modelo de clave ejecutable. Fragmento requiere índice nuevo y tabla propia compatible. EDTRB identifica exclusivamente tabla propia de prueba abierta con estructura y permisos necesarios; ejemplos no se destinan a tablas estándar. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

DBCreateIndex( <cName>, <cExprKey>, [bExprKey], [lUnique] ) --> Nil

Parámetros

cName
CarácterObligatorio

Nombre nuevo, distinto de tabla en TOPCONN.

cExprKey
CarácterObligatorio

Expresión de clave en texto.

bExprKey
Bloque de códigoOpcional

Expresión ejecutable equivalente.

lUnique
LógicoOpcional

Opción de índice único; comprobar RDD.

Retorno

Nil; no es indicador lógico de éxito.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed329()
    // ED_NEWIDX debe estar libre; EDTRB propia tiene campo ED_COD.
    If Select("EDTRB") > 0
        EDTRB->(DBCreateIndex("ED_NEWIDX", "ED_COD", {|| ED_COD}, .F.))
    EndIf
Return Nil
Resultado esperado

Propone crear índice y cambiar orden de prueba; no es consulta neutra. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Comprobar RDD, alias y operaciones pendientes. Navegación puede guardar cambios; preservar contexto según contrato y tratar errores en rutina completa.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. DbCreateIndex. TDN. Consulta el 2026-10-26.
  2. EURAI. dbCreateIndex.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado com ressalva sobre o bloco. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha