NUMBER %NEWDOC%
Scopo: Crea il buffer e la
struttura per l'inserimento di un nuovo documento
Sintassi: | |||
%NUMBER% | %NEWDOC% | (%STRING% | nomeatabella[, |
%NUMBER% | seriali = 1]) |
Descrizione: usato per inserire un nuovo
documento all'interno di una tabella (nometabella)
specificata nell'archivio corrente.
In realtà viene allocato lo spazio fisico su disco, preparata la
struttura e inizializzati i valori seriali (se non richiesto esplicitamente
con seriali = 0) per il successivo inserimento
di un nuovo documento sul database.
L'inserimento vero e proprio avviene solo all'atto del salvataggio del
buffer generato con questa funzione.
Valore restituito: valore numerico
Torna 1 in caso di esito positivo;
Torna 0 in caso di errore generico.
Vedere anche: %SAVEDOC%, %FILLATTR%, %FILLBINATTR%, Database: documenti
Esempio:
%IF%(%NEWDOC%(%KEYVAL%("TIPOREC"), 1) == 0 )
%ECHOON%%INCLUDE%(ERR_NEWDOC.HL")%ECHOOFF%
%RETURN%
%ELSE%
%REPEAT%(1,%NUMTUPLES%)
%IF%( %FILLATTR%(%TUPLEKEY%, %TUPLEVAL%) == 0 )
%ECHOON%%INCLUDE%("ERR_SAVEATTR.HL")%ECHOOFF%
%RETURN%
%ENDIF%
%ENDREPEAT%
%ENDIF%
%IF%(%SAVEDOC% <= 0)
%ECHOON%%INCLUDE%("NO_SAVED.HL")%ECHOOFF%
%ELSE%
%ECHOON%%INCLUDE%(QBE.HL")
%ENDIF%