4D Doc Center : SAVE RECORD

4D v14.3

SAVE RECORD


SAVE RECORD {( tabela )}

Parâmetro	Tipo	Descrição
tabela	Tabela	Tabela para a qual vai salvar o registro atual, ou tabela padrão, se omitido

Descrição

SAVE RECORD guarda o registro atual de tabela no processo atual. Se não houver registro atual, o comando SAVE RECORD é ignorado.

Pode utilizar SAVE RECORD para guardar um registro criado ou modificado por programação. Quando um registro foi modificado e confirmado pelo usuário em um formulário, não é necessário guardar com SAVE RECORD. Um registro que foi modificado pelo usuário em um formulário, mas foi cancelado, mesmo assim podem ser guardados com SAVE RECORD.

Estes são alguns casos onde é necessário SAVE RECORD:

Para guardar um novo registro criado com CREATE RECORD ou DUPLICATE RECORD

Para guardar dados desde RECEIVE RECORD
Para guardar um registro modificado por um método
Para guardar um registro que contenha um subregistro criado ou modificado por um desses comandos ADD SUBRECORD, CREATE SUBRECORD, ou MODIFY SUBRECORD
Durante a entrada de dados, para guardar o registro mostrado antes de chamar um comando que muda o registro atual
Durante a entrada de dados, para guardar o registro atual

Não deve executar SAVE RECORD no evento de formulário On Validate de um registro que foi aceito. Se o fizer, o registro será guardado duas vezes.

Exemplo

O exemplo a seguir é parte de um método que lê registros de um documento. Nessa parte do código, é recebido um registro, e depois, se receber corretamente, o registro é guardado:

 RECEIVE RECORD([Clientes]) ` Recepção do registro a partir do disco

 If(OK=1) ` Se o registro é recebido corretamente…

    SAVE RECORD([Clientes]) ` guardar

 End if