lUnlockLógicoOpcional
Libera locks anteriores quando verdadeiro; padrão .T.
FUNçãOEm revisão
DbAppend
DBAppend( [lUnlock] ) --> NilInclui um registro vazio na tabela corrente.
Visão geral
DBAppend adiciona um registro vazio e retorna Nil. lUnlock verdadeiro, padrão, libera locks anteriores; falso os mantém. Essa opção não substitui a gestão de bloqueio e transação do processo. O fragmento usa falso explicitamente e não atribui campos: uma rotina completa precisa tratar falha da inclusão e validar o registro antes de continuar. 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)
Sintaxe
DBAppend( [lUnlock] ) --> NilParâmetros
Retorno
Nil; não é um indicador lógico de sucesso.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed323()
// EDTRB deve ser propria, descartavel e gravavel em homologacao.
If Select("EDTRB") > 0
EDTRB->(DBAppend(.F.))
EndIf
Return NilResultado esperado
Solicita inclusão vazia se EDTRB estiver aberta; não é teste completo de persistência. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- 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.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.