Database: Documenti

L'accesso ai dati è subordinato all'apertura di un archivio, che avviene automaticamente eseguendo il link di avvio dell'applicazione (predisposto da un operatore) oppure attraverso la pagina principale degli archivi conosciuti da Highway Application Server.
Per poter accedere ai dati dell'archivio corrente è necessario eseguire prima una interrogazione (mediante chiamata alla %4CALL% o eseguendo un link che esprima una query ed invii le eventuali coppie chiave=valore).
Se e quando sono stati trovati documenti, e quindi è stata resa corrente una selezione (automaticamente l'ultima ricerca con esito positivo imposta la selezione corrente) possiamo accedere al contenuto della selezione e quindi dei singoli documenti trovati.
%CURDOC% automaticamente punta al primo documento della selezione.

Per leggere il contenuto di un documento, è necessario caricarlo in memoria eseguendo la %BLOADDOC% o %LOADDOC%
(è buona norma precedere il caricamento di un documento con una chiamata alla %INVALIDATEDOC% che previene problemi di ricaricamenti non voluti dalla cache del browser).

In modalità visualizzazione %ATTRIB%(<nomeattributo>) o %ATTRVAL%(<nomeattributo>) o %FATTRIB% consentono di leggere il contenuto di un attributo; con %ATTRSIZE%(<nomeattributo>) è possibile conoscernee la dimensione in byte, per evitare di rappresentare sul web dei valori nulli o vuoti;
per gli attributi multiistanza si utilizza %ATTROW% che consente di leggere una riga per volta (per sapere di quante righe è composto il contenuto dell'attributo multiistanza, chiamare prima %ATTROWS% o %NUMROWS% (utile anche per individuare il numero di righe di cui è composto un attributo multiriga).

Dovendo eseguire applicazioni internet/intranet che consentono di accedere al database in modifica, prevedere il blocco del documento (mediante i parametri della %BLOADDOC%) che consente di preservare l'accesso simultaneo in aggiornamento sullo stesso documento di più utenti.
Mentre l'inserimento richiede la preparazione di una apposita zona di memoria mediante %NEWDOC%.
%SAVEDOC% salva le modifiche effettuate sulla base dati.
La scrittura dei dati viene eseguita da %FILLATTR% o %FILLBINATTR% che valorizza i singoli attributi del documento in memoria.
Prima di eseguire il salvataggio, se la base dati prevede attributi derivati, chiamando la %DERIVA% si scatenano gli automatismi previsti.
Di particolare interesse risultano le funzioni di conversione delle date da e verso le basi dati Highway o i formati internazionali che l'applicazione potrebbe richiedere.
La data è gestita in formato aaaammgg (4 cifre per l'anno, 2 per il mese e 2 per il giorno).
%DATE%, %DATE2ATTR%, %DATE2JD% e %DATE$% consentono di eseguire le idonee conversioni dal formato interno verso i formati internazionali.

Mentre per eliminare i documenti usare %DELETEDOC% o %DELETENUMDOC%.