query()-Funktion: SQL-Statements an die Datenbank senden

Das ZMSSqldb-Objekt kann mit seiner API-Funktion query() im DTML-Code SQL-Statements ausführen. Es kann per SQL aus einer Datenbank-Tabelle Listen bzw. Tupel generieren und erlaubt z.B. Iterationen, wie sie im Folgenden dargestellt sind:

1  <dtml-let res="e2.query('SELECT * FROM TEST')">
2    <dtml-in "res['columns'][0:2]" mapping>
3      <dtml-var "_['sequence-item']['id']">
4    </dtml-in>
5    <hr/>
6    <dtml-in "res['records']">
7      <dtml-var "_['sequence-item']['NAME']">, 
8      <dtml-var "_['sequence-item']['VORNAME']"><br />
9    </dtml-in>
10 </dtml-let>

In Zeile 1 wird das zu iterierende Objekt über ein SQL Statement erzeugt (in diesem Fall die gesamte Tabelle). Die erste Iteration (Zeile 2) erzeugt eine Liste der ersten drei Spaltenbezeichner (columns) und gibt deren IDs aus. Die zweite Iteration (Zeile 6) durchläuft die Datenfelder (records) und gibt in diesem Beispiel die Felder mit den IDs „Name“ und „Vorname“ aus.