Specifiche tecniche dBaseWeb

Funzioni di dBaseWeb
Richiamare la pagina standard non è l'unico modo di dialogare con il database. I comandi precedenti sono in grado di popolare una frame o una iframe, oppure
di reindirizzare la navigazione verso la pagina di gestione del database, ma non esauriscono le possibilità di dBaseWeb, né certe particolari esigenze, per
esempio sono adatti per restituire direttamente una immagine in formato binario come si aspetta il tag <img>.
Per fare qusto bisogna effettuare una chiamata diretta al programma con opportuni parametri.
Dato che una "incarnazione" o istanza di dBaseWeb viene creata appositamente per svolgere un determinato set di funzioni, ognuna ha un nome diverso. In
questo caso il motore di gestione del database prodotti si chiama motpro.cgi. La chiamata diretta a dBaseWeb si effettua quindi richiamando motpro.cgi, il
quale essendo un programma cgi (common gateway interface) si trova nella directory standard /cgi-bin/
Chiamata diretta a dBaseWeb
Ogni comando viene emesso con la seguente sintassi (la parte racchiusa tra parentesi quadre può essere opzionale):
[<indirizzo del server>]/cgi-bin/<nome del motore>?</codice path/>&<comando>[parametri separati da &] dove:
<indirizzo del server> è necessario quando il comando viene emesso da una pagina che risiede su un dominio diverso da quello su cui è installato il motore
(cioè se la prima parte dell'URL http:/<qualcosa> è la stessa è sufficiente /cgi-bin/<ecc>)
/cgi-bin/ è la directory standard in cui sul server sono installati i programmi
<nome del motore> è il nome della particolare implementazione di dBaseWeb
il punto interrogativo è un carattere speciale per indicare nell'URL l'inizio della query string
<codice path> è il codice di una specifica implementazione e rappresenta il nome della directory sul server nella quale stanno gli archivi dei dati. Questo
codice vi viene fornito quando viene effettuata la registrazione ed è univoco, dato che i dati di ciascun utilizzatore sono gestiti separatamente.
<comando> è uno dei comandi che la particolare implementazione accetta
<&> è un altro carattere speciale con funzione di separatore
<parametri separati da &> sono i dati di cui il comando necessita e che ne determinano il risultato.
Il primo parametro è un numero ed è obbligatorio, serve ad indicare il numero di record nell'archivio. Quando il dato non è in realtà necessario o significativo
viene passato uno 0 (zero). Gli altri parametri sono coppie di valori separati dal segno “=”. (ma non tutti i comandi richiedono altri parametri). Esempio:
l'immagine qui sotto ha come tag:
<img src="http://test.appliserver.com/cgi-bin/motpro.cgi?/cat/&getimg&1">
Comandi utilizzabili senza autenticazione utente
link Visualizza la scheda di un articolo
getcat Visualizza la lista delle categorie
getimg Richiama una immagine in formato binario
search Effettua una ricerca
start Crea la pagina di gestione

I comandi che richiedono autenticazione devono essere gestiti via Javascript e sono trattati a parte