1. "ThGerarchico"
Costante che risolve la molteplicità d'uso della funzione %5CALL%.

2. Attributo
Indica l'attributo che si intende interrogare sul Thesauro gerarchico;
(1 rappresenta verso il basso; 2 verso l'alto).

3. ChiavePosizionamento
Indica la chiave sulla quale posizionarsi all'atto dell'apertura del Thesauro

4. Direzione
Indica la direzione verso la quale orientare le ricerca rispetto alla chiave di posizionamento

5. NumElementi
Indica il numero massimo di elementi che si vuole ricevere di ritorno dalla interrogazione al Thesauro.

6. Relazioni
Lista, separata da spazi, delle tipologie di relazioni, in forma sintetica, che si intende filtrare rispetto alla richiesta. Le tipiche tipologie di relazioni che si possono richiedere al modulo Thesauro sono :

per esempio:
     forma sintetica                     forma estesa
   -----------------------------------------------------------
        NT                             "Termini specifici"
        BT                             "Termini generici"
        RT                             "Termini in relazione"
        SN                             "Note"
        SN                             "Utilizzare"
        UF                             "Utilizzato per"
        VI                             "Vincolato a"
        ICO                            "Classifica"
        IC                             "Classificato in"
        IN                             "In"

Le tipologie di relazioni che si possono instaurare fra i vari termini dichiarati al Thesauro in realta non pongono limiti (la lista sopra indicata è un tipico esempio di relazioni) : l'utente può generare i propri personali tipi di relazione fra i termini dichiarandoli nel file <nomearchivio>.dsp. Per maggiori informazioni Consultare il manuale del Thesauro.

Valore restituito: valore numerico
Torna 0 in caso di errore generico.
In caso di esito positivo vengono valorizzate le variabili %PARENT%, %REL%() e %CHILD%(), mentre %VITEMS% contiene il numero totale di relazioni trovate e %VITEM%() contiene il valore delle chiavi individuate.

Vedere anche: %CHILD%, %HIER%, %INVREL%, %PARENT%, %REL%, %RELDESCR%, %RELNOTE%, %RELPOS%, %THSCOUNT%, %THSDELETE%, %THSGREATER%, %THSGROWSELE%, %THSINSERT%, %THSITEM%, %THSKEYS%, %THSNEXT%, %THSPREV%, %THSREAD%, %THSREL2KEY%, %THSRELDESCR%, %THVDELETE%, %THVINSERT%, %THVNEXT%, %THVPREV%, %THVREAD%, %TOTREL%

Esempio:
%NUMBER%(ret, %5CALL%("ThGerarchico", "INDIR", "Piazza", 1, 10, "BT, NT"))
%IF%(ret)
 %REPEAT%(1, %VITEMS%)
  %WRITE%(%ITEM%)
 %ENDREPEAT%
%ENDIF%

Program output
Piazza dei Mille
Piazza del Popolo
....

Annotazioni

Dalla release 3.2.5.6 di Highway Application Server è consentita l'interrogazione del thesauro dei vincolati anche se residente sul file <nomearchivio>.thv;
sono necessarie le seguenti impostazioni generali:

• che l'archivio preveda l'uso dei vincolati (sezione [THVincolati] in <nomearchivio>.ini);
• che nel <nomearchivio>.dsp, nella sezione [Relazioni], sia impostata una delle chiavi "Appartenenza Vincolati" o "Relazione Vincolati"
• che venga indicata, nel <nomearchivio>.dsp, la riga della sezione [Relazioni] per l'utilizzo di termini in relazioni (tipicamente la chiave: RT, RT, "Termini in relazione")

La funzione BrowseGerarchico:

• parametro1 %STRING% "BrowseGerarchico" (costante)

• parametro2 %STRING% Stato

• parametro3 %STRING% Tabelle

• parametro4 %NUMBER% Documento

• parametro5 %NUMBER% Modo

• parametro6 %NUMBER% NumElementi

1. "BrowseGerarchico"
Costante che risolve la molteplicità d'uso della funzione %5CALL%.

2. Stato
numero documento di riferimento e, opzionalmente, la selezione con cui limitare la navigazione (codificata come da riga comandi e preceduta del carattere '@') e lo stato del BrowseGerarchico separati da virgola.
Le suddette informazioni sono codificate all'interno del parametro Stato; la composizione di Stato con queste modalità, deve essere fatta concatenando i valori all'interno di una variabile stringa, che diverrà poi il parametro Stato, e che Highway Application Server provvederà a distinguere durante l'elaborazione della chiamata %5CALL%.
p.es. startdoc, [@sele], stato
Per selezione si instende il valore tipico di %SELPATH%, che restringerà la selezione all'insieme dei documenti idonei.

3. Tebelle
l'elenco delle tabelle utili (id numerico) separate da virgola, una stringa vuota implica tutte le tabelle.

4. Documento
identifica il documento da esplodere/implodere;
-1 se non è specificato.

5. Modo
può aasumere i seguenti valori :

• 1 pagina successiva
• 2 pagina precedente
• 3 prima pagina
• 4 ultima pagina
• 7 posizionamento
• 32 vista esplosa delle relazioni

6. NumElementi
numero massimo di elementi da tornare.

Valore restituito: valore numerico
Torna 0 in caso di errore generico.
Torna 1 in caso di esito positivo; verranno valorizzate le variabili %BITEMS%, %BITEM%, %BSTAT%

Vedere anche: %BDOC%, %BEXP%, %BFIRST%, %BITEM%, %BITEMS%, %BLAST%, %BPURE%, %BSONS%, %BUPDATE%, %BBROTHERS%, %BINVALID%

Esempio:
%STRING%(stato, "")
%STRCPY%(stato, %NUMDOC%)
%STRCAT%(stato, ",")
%STRCAT%(stato, %BSTAT%)
<!-- esegue una richiesta di browse gerarchico a partire dal documento
indicato con %NUMDOC%; esegue la ricerca su tutte le tabelle;
espande il ramo individuato da %NUMDOC%; esegue un posizionamento sul
browse gerarchico; ritorna il numero di elementi indicati dalla variabile
abientale d'archivio-->

%IF%(%5CALL%("BrowseGerarchico", stato, "", %NUMDOC%, 7, "Max Righe Browse"))
 <!-- elaborazione righe ritornate dalla 5CALL -->
%ELSE%
 <!--errore generico -->
%ENDIF%

Annotazioni

I parametri [@sele] e Stato sono disponibile a partire dalla versione 3.2.6.3 Highway Application Server.