<
Net.Data verfügt über zahlreiche integrierte Funktionen, die die Entwicklung von Web-Seiten vereinfachen. Diese Funktionen sind von Net.Data bereits definiert, d. h. Sie brauchen sie nicht mehr zu definieren. Sie können diese Funktionen so wie andere Funktionen aufrufen.
Abbildung 7 zeigt die Interaktion zwischen den integrierten Net.Data-Funktionen und dem Makro.
Abbildung 7. In Net.Data integrierte Funktionen
<
Es gibt drei Methoden, mit denen integrierte Funktionen ihre Ergebnisse zurückgeben können. Dies hängt vom Präfix ab.
Einige integrierte Funktionen unterstützen nicht jede Art. Wenn Sie ermitteln möchten, um welche Art es sich bei einer bestimmten integrierten Funktion handelt, ziehen Sie das Kapitel zu den integrierten Net.Data-Funktionen im Handbuch Net.Data Reference zu Rate.
In den folgenden Abschnitten wird eine allgemeine Übersicht über die integrierten Net.Data-Funktionen gegeben. Mit diesen Funktionen können Sie allgemeine und mathematische Funktionen sowie Zeichenfolge-, Wort- bzw. Tabellenbearbeitungsfunktionen ausführen. Außerdem können Sie permanente Funktionen für die Transaktionsverarbeitung verwenden. Beschreibungen der einzelnen Funktionen mit Syntax und Beispielen finden Sie im Handbuch Net.Data Reference. Für einige dieser Funktionen müssen Variablen definiert werden, bevor sie verwendet werden können, oder sie müssen in einem spezifischen Kontext verwendet werden. Nicht alle Betriebssysteme unterstützen jede integrierte Funktion. Sie können anhand des Handbuchs Net.Data Reference ermitteln, welche Funktionen für Ihr Betriebssystem unterstützt werden.
Mit Hilfe dieser Gruppe von Funktionen können Sie Web-Seiten durch Ändern von Daten oder Zugreifen auf Systemservices entwickeln. Damit können Sie E-Mail senden, HTTP-Cookies verarbeiten, HTML-Escape-Codes generieren und andere nützliche Informationen vom System abrufen.
Sie verwenden zum Beispiel die Funktion DTW_EXIT, um festzulegen, daß Net.Data ein Makro verlassen soll, ohne die restlichen Anweisungen des Makros zu verarbeiten, wenn eine bestimmte Bedingung eintritt:
%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>
%}
Eine weitere nützliche Funktion ist die Funktion DTW_URLESCSEQ, die Zeichen, die in einer URL-Adresse nicht zulässig sind, durch die entsprechenden Escape-Werte ersetzt. Wenn beispielsweise die Eingabevariable string1 den Inhalt "Guys & Dolls" hat, ordnet DTW_URLESCSEQ die Ausgabevariable dem Wert "Guys%20%26%20Dolls" zu.
Eine Liste gültiger allgemeiner Funktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Diese Funktionen führen mathematische Operationen aus, über die Sie numerische Daten berechnen und ändern können. Neben den mathematischen Standardoperationen können auch Modulus-Divisionen ausgeführt, eine Ergebnisgenauigkeit angegeben und Exponentialschreibweise verwendet werden.
Zum Beispiel potenziert die Funktion DTW_POWER den Wert des ersten Parameters mit dem Wert des zweiten Parameters und gibt das Ergebnis zurück. Siehe dazu das folgende Beispiel:
@DTW_POWER("2", "-3", result)
DTW_POWER gibt ".125" in der Variablen result zurück.
Eine Liste gültiger mathematischer Funktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Diese Funktionen können zum Bearbeiten von Zeichen in Zeichenfolgen verwendet werden. So können Sie zum Beispiel eine Zeichenfolge von Klein- in Großschreibung (oder umgekehrt) umsetzen, Zeichen einfügen oder löschen, einen Zeichenfolgewert einer anderen Variablen zuordnen und noch andere nützliche Funktionen ausführen.
Zum Beispiel können Sie DTW_ASSIGN verwenden, um den Wert einer Eingabevariablen einer Ausgabevariablen zuzuordnen. Sie können diese Funktion auch verwenden, um eine Variable in einem Makro zu verwenden. Im folgenden Beispiel wird der Variablen RC Null zugeordnet.
@DTW_ASSIGN(RC, "0")
Weitere Zeichenfolgefunktionen sind DTW_CONCAT zum Verknüpfen von Zeichenfolgen und DTW_INSERT zum Einfügen von Zeichenfolgen an einer bestimmten Position sowie viele andere Funktionen zum Bearbeiten von Zeichenfolgen.
Eine Liste gültiger Zeichenfolgefunktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Diese Funktionen können zum Bearbeiten von Wörtern in Zeichenfolgen verwendet werden. Die meisten dieser Funktionen arbeiten auf ähnliche Weise wie Zeichenfolgefunktionen, jedoch bezogen auf ganze Wörter. Hiermit können Sie zum Beispiel die Anzahl der Wörter in einer Zeichenfolge zählen, Wörter entfernen oder nach einem Wort in einer Zeichenfolge suchen.
Verwenden Sie beispielsweise DTW_DELW0RD, um eine bestimmte Anzahl von Wörtern aus einer Zeichenfolge zu löschen:
@DTW_DELWORD("Now is the time", "2", "2", result)
DTW_DELWORD gibt die Zeichenfolge "Now time" zurück.
Weitere Wortfunktionen sind DTW_WORDLENGTH (gibt die Anzahl der Zeichen in einem Wort zurück) und DTW_WORDPOS (gibt die Position eines Worts in einer Zeichenfolge zurück).
Eine Liste gültiger Wortfunktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Diese Funktionen können zum Generieren von Berichten oder Formularen mit Hilfe der Daten in einer Net.Data-Tabellenvariable verwendet werden. Mit diesen Funktionen können Sie auch Net.Data-Tabellen erstellen sowie Werte in diesen Tabellen bearbeiten und abrufen. Tabellenvariablen enthalten eine Gruppe von Werten und ihre zugehörigen Spaltennamen. Sie bieten eine bequeme Möglichkeit, ganze Wertegruppen an eine Funktion weiterzugeben.
Zum Beispiel fügt DTW_TB_APPENDROW eine Zeile an die Tabelle an. Im folgenden Beispiel fügt Net.Data zehn Zeilen an die Tabelle myTable an:
@DTW_TB_APPENDROW(myTable, "10")
Außerdem gibt DTW_TB_DUMPH den Inhalt einer Makrotabellenvariablen zurück, die in die Befehle <PRE></PRE> eingeschlossen ist, wobei jede Zeile der Tabelle in einer anderen Zeile angezeigt wird. DTW_TB_CHECKBOX gibt einen oder mehrere HTML-Markierungsfeldeingabefehle aus einer Makrotabellenvariablen zurück.
Eine Liste gültiger Tabellenfunktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Die FFI-Schnittstelle (Flat File Interface - Schnittstelle für unstrukturierte Textdateien) kann zum Öffnen, Lesen und Bearbeiten von Daten aus unstrukturierten Textdateiquellen (Textdateien) sowie zum Speichern von Daten in unstrukturierte Textdateien verwendet werden.
Zum Beispiel schreibt DTWF_APPEND den Inhalt einer Tabellenvariablen an das Ende einer Datei, und DTWF_DELETE löscht Sätze aus einer Datei.
Außerdem unterstützen die FFI-Funktionen Dateisperren mit DTWF_CLOSE und DTWF_OPEN. DTWF_OPEN sperrt eine Datei, damit sie eine andere Anforderung weder lesen noch aktualisieren kann. DTWF_CLOSE gibt die Datei frei, wenn Net.Data sie nicht länger benötigt, damit andere Anforderungen auf die Datei zugreifen können.
Eine Liste gültiger Funktionen für unstrukturierte Textdateien mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Die Funktionen für Web-Registrierdatenbanken können zum Verwalten der Registrierdatenbanken und der darin enthaltenen Einträge verwendet werden. Eine Web-Registrierdatenbank ist eine Datei mit einem von Net.Data verwalteten Schlüssel, die das einfache Hinzufügen, Abrufen und Löschen von Einträgen ermöglicht.
Zum Beispiel fügt DTWR_ADDENTRY Einträge hinzu, während DTWR_DELENTRY Einträge löscht. DTWR_LISTSUB gibt Informationen zu den Registrierdatenbankeinträgen in einem OUT-Tabellenparameter zurück, und DTWR_UPDATEENTRY ersetzt vorhandene Werte für einen angegebenen Registrierdatenbankeintrag durch einen neuen Wert.
Eine Liste gültiger Funktionen für Web-Registrierdatenbanken mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.
Die permanenten Makrofunktionen unterstützen die Transaktionsverarbeitung in Net.Data, indem Sie definieren können, welche Makroblöcke in einer einzelnen Transaktion permanent sind. Verwenden Sie diese Funktionen, um den Anfang und das Ende einer Transaktion zu definieren und den Geltungsbereich der Variablen in der Transaktion zu definieren sowie um festzulegen, welche HTML-Blöcke in der Transaktion permanent sind und ob für Änderungen in der Transaktion eine COMMIT- oder eine ROLLBACK-Operation ausgeführt werden soll.
Zum Beispiel gibt DTW_ACCEPT die Transaktionskennung für eine Transaktion an, während DTW_TERMINATE den letzten HTML-Block in der Transaktion angibt. DTW_RTVHANDLE generiert eine eindeutige Transaktionskennung für Blöcke in der Transaktion. Sie können DTW_COMMIT und DTW_ROLLBACK verwenden, um in der Transaktion COMMIT- und ROLLBACK-Operationen einzuleiten.
Weitere Informationen hierzu finden Sie in Transaktionsverwaltung mit permanenten Makros. Eine Liste gültiger permanenter Funktionen mit Syntax und Beispielen finden Sie im Kapitel über integrierte Funktionen im Handbuch Net.Data Reference.