Opzioni sulla riga di comando di Highway Application Server.

Eseguire un avvio del servizio Highway Application Server mediante riga di comando consente di impostare parametri d'avvio al modulo HiCgi.exe

Opzioni sulla riga di comando del modulo 'h3'

H3[opzioni][[|]?[[!][<|>][*]]|[|]["]
ATTRIBUTO[|ATTRIBUTO[|...]]=VALORE[;[[!][<|>][*]]|[|]["]ATTRIBUTO[|ATTRIBUTO[|...]]=VALORE[;...]]]
 

/A<nomeancora>

viene generata una URL con questa opzione per la esecuzione automatica dei rimandi associati a un documento.

Esempio::
<A HREF=%SCRIPT%/a%CURARC%/Aancora1>Vai al doc</A>

/a<archivio>

specifica il nome dell'archivio; è anche possibile usare un riferimento numerico se si predispone una sezione [Archivi] in HICGI.INI con voci del tipo: n = archivio.
Se nella sezione [CGI] di archivio è presente la voce CDRoot, viene interpretato anche un percorso completo ottenuto sostituendo il carattere '\' con '!' (es:'c:!archivi!test.sts')

Esempio::
<FORM ALIGN=CENTER METHOD=POST ACTION="%SCRIPT%/a1/t">

/B['x']startdoc[,@sele],stato

richiesta della pagina precedente di browse gerarchico.
Il carattere 'x' (opzionale) richiede l'esplosione di tutti gli elementi ritornati;
startdoc identifica il documento di partenza della precedente pagina di browse gerarchico;
@sele (opzionale) utilizzato per fornire una selezione di documenti idonea alla navigazione (nome del file di selezione preceduto dal carattere '@');
stato esprime lo stato corrente del browse gerarchico.

Esempio::
%STRING%(sele, %CURSELPATH%)
%STRING%(for_b, "")
%STRCAT%(for_b, "x")
%STRCAT%(for_b, %itoa%(%CURDOC%))
%STRCAT%(for_b, ",@")
<!-- eventuale elaborazione del file di selezione -->
%STRCAT%(for_b, sele)
%STRCAT%(for_b, ",")
%STRCAT%(for_b, %BSTAT%)
<A HREF=%SCRIPT%/a%CURARC%/B%WRITE%(for_b)>

Annotazioni

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

/b['x']startdoc[,@sele],stato

richiesta della pagina successiva di browse gearachico.
Il carattere 'x' (opzionale) richiede l'esplosione di tutti gli elementi ritornati;
startdoc identifica il documento di partenza della precedente pagina di browse gerarchico;
@sele (opzionale) utilizzato per fornire una selezione di documenti idonea alla navigazione (nome del file di selezione preceduto dal carattere '@');
stato esprime lo stato corrente del browse gerarchico.

Esempio::
%STRING%(sele, %CURSELPATH%)
%STRING%(for_b, "")
%STRCAT%(for_b, "x")
%STRCAT%(for_b, %itoa%(%CURDOC%))
%STRCAT%(for_b, ",@")
<!-- eventuale elaborazione del file di selezione -->
%STRCAT%(for_b, sele)
%STRCAT%(for_b, ",")
%STRCAT%(for_b, %BSTAT%)
<A HREF=%SCRIPT%/a%CURARC%/b%WRITE%(for_b)>

Annotazioni

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

/C<nomecollegamento>

viene generata una URL con questa opzione per la esecuzione dei rimandi associati a un documento.

Esempio:
<A HREF=%SCRIPT%/a%CURARC%/Aancora1/Cnomecollegamento>Vai al doc</A>

/d<nnn>

specifica il numero progressivo in base 1 del documento nella selezione al quale accedere oppure l'identificativo di documento in una pagina di browse.

Esempio::
<A HREF="%SCRIPT%/a%CURARC%/s%CURSEL%/d%EVAL%(max(%CURDOC%-%PERPAGE%+1,1))/t">"</A>

/e

rende disponibili anche le tuple vuote.
Se nella header "Content-type:" della richiesta HTTP viene specificato
<FORM enctype="multipart/form-data" le tuple vuote sono comunque disponibili.

/f<idfile>

richiede di processare il file dichiarato alla voce corrispondente in HICGI.INI nella sezione [Generico] o nella sezione [CGI] di <nomearchivio>.ini se usato con /a.

Esempio::
<nomearchivio.ini>
[CGI]
Form Selezione = hl\asiriqbe.hl
Form Titoli = hl\asiriqbe.hl
Form Documento = hl\asiriqbe.hl
Form Vocabolario = hl\idx.hl
Classificazione = hl\altro.hl
<Riga di comando>
<A HREF=%SCRIPT%/a4/fClassificazione>Classificazione</A>

Annotazioni

A partire dalla versione 3.2.7.2 di Highway Application Server la risoluzione dei nomi degli script Highway Language non dichiarati nei suddetti file ini, avviene automaticamente nei confronti del sottodiretorio hl del direttorio d'archivio corrente e nel sottodirettorio hl del direttorio nel qualsi si trova Highway Application Server stesso.

Annotazioni

/fhinfo>
L'utilizzo di questo parametro è associato all'uso della %SYSINFO%.
Inserendo questo parametro nella riga di camando o nell'href di un link, è consentito ad una chiamata della %SYSINFO% di estrarre informazioni di sistema relativamente al modulo Highway Remote Application Server e al Modulo di interfaccia verso il Web Server, diversamente non disponibili.
Il presente parametro può essere utilizzato anche insieme ad un 'comune' /f<idfile>.

Esempio:
<A HREF=%SCRIPT%/a4/fhinfo/fClassificazione>Classificazione</A>

Disponibile a partire dalla versione 3.2.7.2 di Highway Application Server.

/F<idfile>

come /f ma rende disponibile in %SELDATA% la frase di ricerca generata processando le coppie chiave/valore ricevute da una form o su riga di comando (vengono ignorate le chiavi con estensione .x o .y).

Commento:
Per passare coppie chiave-valore in riga di comando senza che vengano inserite in %SELDATA%, assegnare alle tuple nomi con estensione .x o .y.
Esempio: chiave1.x=valore1

/g<nomefile> (Obsoleta)

richiesta di trasferimento di un file: a seguito di un POST generato da una 'form' di selezione alcuni browser usano ancora POST per risolvere eventuali URL all'interno del documento tornato, con disappunto del server NCSA che si rifiuta di cooperare. Usare la URL (sostituendo '/' con '!') come argomento dello Script con questa opzione. Questo meccanismo viene usato automaticamente per le URL relative ai thumbnails dell'archivio.

Commento:
Per l'accesso alle immagini, definire nei 'mapping' del server WEB per ogni drive coinvolto un alias del tipo /C/ C:/ (MAIUSCOLO!)

/H

richiesta della pagina precedente del thesaurus.
Il nome dell'attributo e la chiave di partenza vanno specificati in una coppia <nomeattributo=valore>.

Esempio::
<A HREF="/h3/h3.exe/a1/H?SOGGETTI=Ultimo">

/h

richiesta della pagina successiva del thesaurus.
Il nome dell'attributo e la chiave di partenza vanno specificati in una coppia <nomeattributo=valore>.

Esempio::
<A HREF="/h3/h3.exe/a1/h?SOGGETTI=Radice">

/i<nnn>

richiesta di una pagina di thumbnails a partire dall'immagine <nnn>
(va usata unitamente a /a, /d e /s).

Esempio::
<A HREF="%SCRIPT%/a%CURARC%/s%CURSEL%/d%EVAL%(max(%CURDOC%-%PERPAGE%+1,1))/i1">"</A>

/p<nnn>

richiesta della <nnn>esima immagine di un documento
(va usata unitamente a /d e /s).

Esempio:
<A HREF="%SCRIPT%/a%CURARC%/s%CURSEL%/d%EVAL%(max(%CURDOC%-%PERPAGE%+1,1))/p5"></A>

/q<nomecampo=valore>

specifica una condizione per la frase di ricerca
(equivalente ad una coppia chiave=valore nella query-string).

Esempio::
<A HREF="%SCRIPT%/a%CURARC%/qATTRIBUTO=valore"></A>

/r<nnn>

usata unitamente a /p specifica il gruppo all'interno del documento.
In questo caso il valore in /p viene interpretato come indice di pagina all'interno del gruppo.

Esempio::
<A HREF="%SCRIPT%/a%CURARC%/s%CURSEL%/d%EVAL%(max(%CURDOC%-%PERPAGE%+1,1))/r2/p5"></A>

/S<frasericerca>

specifica il contenuto della frase di ricerca: valorizza %SELDATA% se presente in ingresso nella richiesta in corso di elaborazione; va valorizzato con %SELDATA% nella compilazione di un link che trasmetta il contenuto della frase di ricerca.

Esempio::
<a href="%SCRIPT%/a%CURARC%/t/S%SELDATA%">

/s<filesele>

specifica l'identificativo della selezione: valorizza %CURSEL% se presente in ingresso nella richiesta in corso di elaborazione; va valorizzato con %CURSEL% nella compilazione di un link che referenzi la selezione corrente.

Esempio::
<a href="%SCRIPT%/a%CURARC%/s%CURSEL%/d%EVAL%(%CURDOC%+%INDEX%)/S%SELDATA%">

/T<tabelle>

elenco delle tabelle abilitate nel browse gerarchico.

Esempio::
<A HREF=%SCRIPT%/a%CURARC%/B100/T2,4,11>

/t

usato con /s /d e /a comporta il caricamento dello script dichiarato alla voce 'Form Titoli' della sezione [CGI] dell'ini di archivio (se assente della sezione [Generico] di hicgi.ini) per la presentazione di una pagina di titoli dei documenti selezionati a seguito di una ricerca.

Esempio::
<FORM ALIGN=CENTER METHOD=POST ACTION="%SCRIPT%/a1/t">

/V

richiesta della pagina precedente del vocabolario.
Il nome dell'attributo e la chiave di partenza vanno specificati in una coppia <nomeattributo=valore.

Esempio::
<A HREF="%SCRIPT%/a%CURARC%/V?OGGETTO=ZZZZ"></A>

/v

richiesta della pagina succesiva del vocabolario.
il nome dell'attributo e la chiave di partenza vanno specificati in una coppia <nomeattributo=valore.

Esempio::
<A HREF="%SCRIPT%/a1/v?OGGETTO=AAAA">

N.B.: Le funzioni di vocabolario e thesaurus richiedono il modulo thlib.dll.

Opzioni sulla riga di comando del browser

E' possibile utilizzare, sulla riga di comando del browser, un particolare carattere, il punto interrogativo ('?'), che invia ad Highway Server quanto specificato nei caratteri successivi.

• Raffinamento
  Per eseguire una ricerca in raffinamento, cioè una ricerca su una selezione esistente, si può fare uso della seguente sintassi:
  %SCRIPT%/a%CURARC%/t%3f=%QSTRING%("[?SEL]=")%22%QSTRING%(%CURSELPATH%)%22
  che tradotto significa mettere dopo il punto interrogativo ('%3f') il segno di uguale ('=') e la parola chiave '[?SEL]=' con a seguito il nome completo del file di selezione ('%CURSELPATH%').
  Questa riga di comando indica ad Highway Server che la successiva query da eseguire deve interrogare il set di documenti individuato dalla precedente selezione.
  Si intende che questa url deve essere utilizzata nella action di un tag <FORM> che invierà, al submit, la suddetta url e le coppie chiave-valore che specificano la frase di ricerca che raffinerà la suddetta selezione.