NUMBER %BLOADDOC%
Scopo: Rende disponibili i dati
del documento specificato.
| Sintassi: | |||
| %NUMBER% | %BLOADDDOC% | (%NUMBER% | doc[, |
| %NUMBER% | caricaancore[, | ||
| %NUMBER% | azioniarichiesta = 1[, | ||
| %NUMBER% | lock = 0) | ||
Descrizione: consente il caricamento del documento
identificato da doc che assume valenze diverse in base
al contesto in cui viene utilizzato: se esiste una selezione corrente,
%CURDOC% identifica la posizione del documento fra quelli selezionati,
diversamente rappresenta il numero fisico univoco del documento all'interno
della base dati.
caricaancore carica le 'ancore' relative al
documento indicato; assume i seguenti valori :
Il funzionamento di questo parametro dipende da quanto
indicato nel <nomearchivio>.ini oppure
nell'sfplus.ini alla sezione
[HS] nella riga DirLink.
Se DirLink = no il motore HS scarta qualsiasi
richiesta di caricamento delle ancore.
azioniarichiesta indica al motore
HS di eseguire le azioni indicate nel <nomearchivio>.ini
relative agli attributi con proprietà 'esterno a richiesta'.
lock può assumere i seguenti valori:
0 : il documento viene caricato senza essere bloccato;
1 : richiede il blocco del documento.
Per sbloccare il documento impostare il parametro flags = 2
in %SAVEDOC% o chiamare %UNLOCKDOC%.
In caso di esito positivo sarà possibile accedere ai dati del documento.
%BLOADDOC% viene usato in alternativa a %LOADDOC% quando si presume necessario
testare il corretto caricamento di un documento.
Valore restituito: valore numerico
Torna 1 in caso di caricamento avvenuto correttemente.
Torna 0 in caso di errore generico.
Vedere anche: %NEWDOC%, %DOCTITLE%, %SAVEDOC%, %LOADDOC%, %INVALIDATEDOC%, %LOCK%, %UNLOCK%, %UNLOCKDOC%
Esempio:
%INVALIDATEDOC%
%IF%(%BLOADDOC%(%INDEX%))
<!-- operazioni di lettura dei dati del documento -->
%ATTRIB%("NRECORD")
%ATTRIB%("NOME")
...
%ELSE%
<!-- errore di caricamento del documento -->
%ENDIF%
Annotazioni
Il parametro lock è disponibile dalla versione 3.2.6.0 di Highway Application Server.