NUMBER %SAVEDOC%
Scopo: Effettua il salvataggio del documento corrente.

Sintassi:
%NUMBER% %SAVEDOC% [(%NUMBER% Flags=0[,
    %NUMBER% Deriva=0[,
    %NUMBER% Seriali=0]])]

Descrizione: Consente di salvare in modo definitivo il documento corrente sul database, quindi su disco.
Il documento corrente potrebbe essere un documento caricato, mediante la %BLOADDOC%, da una selezione esito di una ricerca, o mediante il numero di documento fisico, oppure un nuovo documento che diviene il documento corrente all'atto della creazione del buffer che lo deve contenere (con una chiamata a %NEWDOC%).
I parametri opzionali assumono il seguente valore:

param valore descrizione
Flags 1 (NoCataloga) tipicamente utilizzato durante importazioni o procedure che eseguono operazioni dispendiose e per le quali è preferibile demandare la catalogazione (vedi indicizzazione) al termine della elaborazione in corso.
Questa condizione è valida solo all'atto di inserimento di nuovi documenti (quindi p.e. in fase di importazione con aggiornamento completo);
importazioni in aggiornamento (parziale o tatale) o documenti esistenti in stato di modifica, saranno comunque catalogati all'atto del salvataggio.
  2 (Locked) Informa Highway Server che il documento del quale si sta richiedendo il salvataggio, è stato bloccato all'atto del caricamento (mediante il flag lock della %BLOADDOC%) e che quindi, per le normali operazioni che devono essere eseguite, questa operazione non deve essere rifatta da parte di Highway Server.
  4 (NoLoadArc) Informa Highway Server che l'archivio corrente è stato in precedenza bloccato (mediante %LOCK% o %DBLOCK%) e che quindi, per le operazioni che Highway Server dovrà eseguire in seguito, l'archivio si trova in questo stato.
Tipicamente è una opzione utilizzata in fase di importazione o comunque per procedure che apportano aggiornamenti sostanziali al database.
  16 (ChkSeriali) Opzione tipica di salvataggio di un nuovo documento che ha allocato il buffer necessario con una %NEWDOC% con il flag seriali = 0, e che quindi richiede ad Highway Server di valorizzare correttamente i valori seriali presenti sul documento in questione.
Tipica situazione che si presenta importando in aggiornamento completo o per inserimento di nuovo documento.
  32 (NoUpdate) Anche questa opzione è tipica delle importazioni in aggiornamento parziale.
Ponendo Flags a 32, si richiede ad Highway Server di assumere che i documenti che violano il vincolo di univocità, non sovrascrivano il documento preesistente, ma che sia creato un nuovo documento posto in coda al database.
Questa situazione viene notificata da Highway Server mediante scrittura sul file "warnings.txt", generalmente posto nel direttorio dei temporanei.
  64 (PartialUpd) Opzione tipica delle operazioni di importazione in aggiornamento parziale.
Gli attributi che non sono indicati nel file da importare (quelli che fisicamente non compaiono) non saranno sovrascritti con un valore vuoto; operazione che invece viene eseguita normalmente in caso di importazione in aggiornamento completo.
I suddetti valori possono essere utilizzati in combinata, sommandoli fra di loro per combinare insieme una serie di comportamenti che si intende richiedere ad Highway Server durante una operazione di salvataggio.
Deriva 0 indica ad Highway Server di non scatenare le azioni (vedi Definizione delle azioni) che valorizzano gli attributi derivati (vedi Proprietà Derivato).
  1 indica ad Highway Server di scatenare le azioni che valorizzano gli attributi derivati prima del salvataggio del documento.
Seriali 0 indica ad Highway Server di non valorizzare i seriali non obbligatori.
  1 indica ad Highway Server di valorizzare i seriali non obbligatori durante il salvataggio del documento.

Valore restituito: valore numerico
Torna un identificativo univoco del documento (numero fisico) in caso di esito positivo;
Torna un valore <= 0 in caso di errore generico.

Vedere anche: %BLOADDOC%, %MKINDEX%, Database: documenti

Annotazioni

L'uso del parametro Seriali e disponibile a partire dalla versione 3.3.0.1 di Highway Application Server.