NUMBER %DOCRELNAVIGATE%
Scopo: consente la navigazione
fra i documenti della base dati.
Sintassi: | |||
%NUMBER% | %DOCRELNAVIGATE% | (%NUMBER% | relaz, |
%NUMBER% | startdoc[, | ||
%STRING% | tabelle[, | ||
%NUMBER% | docpadre[, | ||
%STRING% | buffer]]]) |
Descrizione: consente di navigare all'interno
della base dati attraverso quanto indicato in startdoc
che rappresenta il numero del documento di partenza rispetto alla sua
posizione all'interno del file di selezione, e da relaz
che indica il tipo di relazione che insiste fra startdoc
ed il documento di arrivo.
relaz può assumere i seguenti valori:
vedi %DOCRELINSERT%
La navigazione all'interno dell base dati può essere
ristretta ad un solo gruppo di tabelle indicate attraverso il loro nome
alfanumerico e separate da ',' (virgola) nel parametro tabelle.
Al fine di rendere univoca la navigazione verso il documento di
arrivo, è opportuno, ma non obbligatorio, indicare il numero
fisico (ricavato tramite %NUMDOC%) del 'padre' di startdoc
(nel caso quest'ultimo sia figlio di più padri) nel parametro
docpadre.
buffer può contenere la chiave di
relazione generata tramite la %THSREL2KEY% allo scopo di eliminare
ambiguitą rispetto al documento di arrivo;
buffer, in uscita dalla %DOCRELNAVIGATE%
conterrą la chiave di relazione fra startdoc
ed il documento di arrivo.
Valore restituito: valore numerico
Torna il numero fisico del documento di arrivo se trovato.
Torna 0 in caso di nessun documento in relazione con startdoc.
Non viene compilato dal modulo Highway Application Server in caso
di errore generico.
Vedere anche: %DOCRELDELETE%, %DOCRELGETSEL%, %DOCRELINSERT%, %DOCRELSETROOT%, %DOCRELSELECT%, %DOCRELEMPTY%, Database: relazioni gerarchiche
Esempio:
%NUMBER%(docfinish, %DOCRELNAVIGATE%(%CURDOC%, 1, "TABELLA1,TABELLA2"))
%IF%(docfinish > 0)
%IF%(%BLOADDOC%(docfinish))
<!-- visualizzare il documento di arrivo -->
%ENDIF%
%ELSE%
<!-- nessun documento soddisfa la relazione richiesta rispetto a %CURDOC% -->
%ENDIF%