FUNCIóNEn revisión

DbAppend

DBAppend( [lUnlock] ) --> Nil

Agrega registro vacío a tabla actual.

DbAppendAdvPL

01 · DESCRIPCIÓN GENERAL

Descripción general

DBAppend agrega registro vacío y devuelve Nil. lUnlock verdadero, predeterminado, libera locks anteriores; falso los conserva. No sustituye gestión de bloqueos/transacción. Fragmento usa falso y no asigna campos; rutina completa debe tratar fallo y validar registro antes de continuar. 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

DBAppend( [lUnlock] ) --> Nil

Parámetros

lUnlock

LógicoOpcional

Libera locks anteriores si verdadero; predeterminado .T.

Retorno

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

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed323()
    // EDTRB propia, descartable y grabable en pruebas.
    If Select("EDTRB") > 0
        EDTRB->(DBAppend(.F.))
    EndIf
Return Nil

Resultado esperado

Solicita inclusión vacía si EDTRB está abierta; no prueba persistencia completa. 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

TOTVS. DbAppend. TDN. Consulta el 2026-10-26.

Estado: En revisión
Página creada el: 26/10/2026 a las 10:26
Última revisión el: 26/10/2026 a las 10:26
Idioma original: Portugués
Revisión: Usina.BR