Guida di riferimento per l'interfaccia per l'ambiente di linguaggio
Net.Data utilizza quattro funzioni di interfaccia con un ambiente di
linguaggio: fornire una o più di queste funzioni. Tre di queste
funzioni sono facoltative, ma ogni ambiente di linguaggio deve avere una
funzione di interfaccia dtw_execute(). Se una macro di Net.Data
fa riferimento ad un ambiente di linguaggio che non possiede una funzione di
interfaccia dtw_execute(), Net.Data restituisce un messaggio di errore
e chiude l'elaborazione della macro di Net.Data.
Per richiamare un ambiente di linguaggio, fare riferimento ad esso sul
blocco FUNCTION della macro di Net.Data. Le funzioni di
interfaccia dell'ambiente di linguaggio devono essere richiamate nel
seguente ordine:
- dtw_initialize()
- dtw_execute()
- dtw_getNextRow()
- dtw_cleanup()
La funzione dtw_execute() è la sola funzione di interfaccia che deve essere
fornita in un ambiente di linguaggio.
Quando Net.Data rileva una chiamata ad una funzione che utilizza
l'ambiente di linguaggio, esegue questa procedura per richiamare
l'ambiente di linguaggio:
- Net.Data chiama dtw_initialize() se è stato definito per questo
ambiente di linguaggio. La funzione esegue tutte le attività di
inizializzazione richieste dall'ambiente di linguaggio, come il
collegamento ai database o l'assegnazione di variabili.
- Net.Data chiama dtw_execute() per elaborare il blocco FUNCTION
della macro contenente le istruzioni che l'ambiente di linguaggio deve
elaborare.
- Net.Data chiama dtw_getNextRow() se, alla successiva restituzione,
dtw_execute() ha indicato che deve essere chiamato dtw_getNextRow().
- Quando l'elaborazione della macro di Net.Data è completata,
Net.Data chiama dtw_cleanup() per aggiornare l'ambiente (ad
esempio, scollegandosi dal database o liberando le variabili) se questa
funzione è stata definita per l'ambiente di linguaggio e ritorna poi al
server Web.
Le seguenti sezioni descrivono le funzioni di interfaccia:
[ Inizio pagina | Pagina precedente | Pagina successiva | Indice | Indice analitico ]