Net.Data fornisce un'ampia gamma di funzioni integrate per semplificare lo sviluppo di pagine Web. Queste funzioni sono già definite da Net.Data e non è quindi necessario definirle in un blocco FUNCTION. E' possibile semplicemente chiamare queste funzioni in un punto qualsiasi della macro in cui è possibile chiamare una funzione definita dall'utente.
Viene utilizzato lo stesso metodo per richiamare una funzione integrata da utilizzare per richiamare una funzione definita dall'utente, la chiamata funzione di Net.Data. Figura 7 riporta come interagiscono le funzioni di Net.Data e il file di macro.
Figura 7. Funzioni integrate di Net.Data
|
All'interno di un blocco HTML, Net.Data elabora una chiamata di funzione per la funzione integrata. Net.Data elabora la funzione e poi restituisce tutti i risultati all'interno di un blocco HTML nel file della macro.
Le funzioni integrate possono restituire i risultati in tre modi. Utilizzando un prefisso:
Alcune funzioni integrate non dispongono di ogni tipo. Per stabilire il tipo legato ad una particolare funzione integrata, consultare il capitolo sulle funzioni integrate di Net.Data contenuto in Riferimenti di Net.Data.
Le sezioni che seguono forniscono una panoramica particolareggiata delle funzioni integrate di Net.Data. Utilizzare queste funzioni per eseguire operazioni di natura generale, matematica, di stringa, di parola o di gestione di tabelle. Inoltre è possibile utilizzare funzioni persistenti per l'elaborazione della transazione. Consultare Riferimenti di Net.Data per le descrizioni di ciascuna funzione con la sintassi e gli esempi. Alcune di queste funzioni richiedono l'impostazione delle variabili prima di essere utilizzate o vanno utilizzate in un contesto specifico.
Questa serie di funzioni supporta lo sviluppo delle pagine Web modificando i dati o i servizi di accesso al sistema. E' possibile utilizzarle per eseguire interrogazioni e per impostare variabili di ambiente, per utilizzare codici di uscita HTML e per ottenere informazioni utili dal sistema.
Ad esempio, per specificare che Net.Data deve uscire da una macro se si verifica una condizione specifica, senza elaborare il resto del file della macro, utilizzare la funzione DTW_EXIT:
%HTML(cache_example) {
<html>
<head>
<title>This is the page title</title>
</head>
<body>
<center>
<h3>This is the Main Heading</h3>
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
<! Joe Smith sees a very short page !>
<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!>
%IF (customer == "Joe Smith")
</body>
</html>
@DTW_EXIT()
%ENDIF
...
</body>
</html>
%}
La funzione DTW_URLESCSEQ sostituisce i caratteri non consentiti in un URL con i loro valori di escape. Ad esempio, se la variabile input string1 è uguale a "Guys & Dolls", DTW_URLESCSEQ assegna la variabile output al valore "Guys%20%26%20Dolls".
Queste funzioni eseguono operazioni matematiche, consentendo di calcolare o modificare dati numerici. Oltre a operazioni standard di matematica, è anche possibile eseguire divisione di moduli, specificare con precisione un risultato ed utilizzare l'annotazione scientifica.
Ad esempio, la funzione DTW_POWER aumenta il valore del primo parametro fino al secondo e restituisce il risultato, come riportato nell'esempio che segue:
@DTW_rPOWER("2", "-3", result)
DTW_POWER restituisce ".125"
Queste funzioni consentono di gestire i caratteri all'interno delle stringhe. E' anche possibile modificare i caratteri di una stringa da maiuscoli a minuscoli, inserire o cancellare caratteri, assegnare un valore di stringa ad un'altra variabile, più altre utili funzioni.
Ad esempio, è possibile utilizzare DTW_ASSIGN per assegnare il valore di una variabile input su una variabile output. E' anche possibile utilizzare questa funzione per modificare una variabile in una macro. Nell'esempio che segue, la variabile RC è assegnata a zero.
@DTW_ASSIGN(RC, "0")
Altre funzioni di stringa comprendono DTW_CONCAT, che unisce le stringhe e DTW_INSERT, che inserisce le stringhe sulla posizione specifica e anche altre funzioni di gestione stringa.
Queste funzioni consentono di gestire le parole all'interno di stringhe di caratteri. La maggior parte di queste funzioni operano come le funzioni di stringa, ma su intere parole. Ad esempio, consentono di conteggiare il numero delle parole in una stringa, eliminare parole, ricercare una stringa per una parola.
Ad esempio, utilizzare DTW_DELW0RD per eliminare un numero specificato di parole da una stringa:
@DTW_DELWORD("Now is the time", "2", "2", result)
DTW_DELWORD restituisce la stringa "Now time".
Altre funzioni di parola comprendono DTW_WORDLENGTH, che restituisce il numero di caratteri in una stringa e DTW_WORDPOS che restituisce la posizione di una parola all'interno di una stringa.
E' possibile utilizzare queste funzioni per generare prospetti o moduli utilizzando i dati in una variabile di tabella di Net.Data. E' anche possibile utilizzare queste funzioni per richiedere ed impostare i valori di una variabile di tabella di Net.Data. Le variabili di tabella contengono una serie di valori e i nomi colonna ad essi associati. Essi forniscono un modo conveniente di trasferire gruppi di valori su una funzione.
Ad esempio, DTW_TB_APPENDROW accoda una riga ad una tabella. Nell'esempio che segue, Net.Data accoda dieci righe alla tabella myTable:
@DTW_TB_APPENDROW(myTable, "10")
Inoltre DTW_TB_DUMPH restituisce il contenuto di una variabile di tabella macro, racchiuso tra le tag <PRE></PRE> ed ogni riga della tabella viene visualizzata su una riga diversa. DTW_TB_CHECKBOX restituisce una o più tag di immissione di casella HTML da una variabile di tabella macro.
Utilizzare le funzioni FFI (flat file interface) per aprire, leggere e gestire i dati da origini di file non codificati (file di testo) e per memorizzare dati negli stessi file.
Ad esempio DTWF_APPEND scrive il contenuto di una variabile di tabella alla fine del file e DTWF_DELETE cancella i record da un file.
Inoltre le funzioni FFI consentono il blocco file tramite DTWF_CLOSE e DTWF_OPEN. DTWF_OPEN blocca un file in modo che questo non può essere letto o aggiornato da un altro processo. DTWF_CLOSE rilascia il file quando Net.Data termina di elaborarlo, consentendo ad altri processi di accedere al file.
Utilizzare le funzioni del registro Web per gestire i registri e le voci che essi contengono. Un registro Web è un file contenente una chiave gestita da Net.Data che consente di aggiungere, richiamare e cancellare facilmente le voci.
Ad esempio, DTWR_ADDENTRY aggiunge le voci, mentre DTWR_DELENTRY le cancella. DTWR_LISTSUB restituisce le informazioni sulle voci di registro in un parametro di tabella OUT e DTWR_UPDATEENTRY sostituisce i valori esistenti per una voce di registro specificata con un nuovo valore.
Le funzioni macro persistenti supportano l'elaborazione della transazione in Net.Data semplificando la definizione con blocchi macro persistenti all'interno di una singola transazione. Utilizzare queste funzioni per definire l'avvio e la fine di una transazione, i blocchi HTML persistenti per tutta la durata della transazione, l'ambito delle variabili all'interno della transazione e la convalida o l'annullamento delle modifiche all'interno della transazione.
Ad esempio, DTW_ACCEPT identifica il gestore della transazione, mentre DTW_TERMINATE ne identifica il blocco finale HTML. DTW_RTVHANDLE genera un gestore di transazione univoco per i blocchi. E' possibile utilizzare DTW_COMMIT e DTW_ROLLBACK per avviare le convalide e gli annullamenti durante la transazione.