Der meistverwendete Befehl in easy code generator Vorlagen ist der sogenannte <<columnsubstitution>> Befehl.

Dieser Befehl wird für eine angegebene Anzahl von Spalten innerhalb der ausgewählten Tabelle ausgeführt. So können Sie z.B. in einem SELECT Befehl alle Spaltennamen auflisten oder eine Variablendeklaration für jede Spalte ausführen.

Diesen Befehl können Sie über <Column Parsing> -> <Basic Command> auswählen.

Syntax

{{<<columnsubstitution>><<crlf=false>><<delimiter=>><<columns=all>>– enter your code and available substitution variables here —
<<delimiter>><<endcolumnsubstitution>>}}

Der Befehl hat drei Parameter und einen Eingabebereich an dem Sie beliebigen Text einfügen können:

• crlf (true oder false): gibt an, ob nach jeder Spalte ein Zeilenumbruch gemacht werden soll
• delimiter: beliebiger text der den Eintrag <<delimiter>> bei jeder Spalte ersetzt. Normalerweise werden Aufzählungszeichen wie Kommas oder Strichpunkte verwendet. Der Eintrag <<delimiter>> kann an jeder Stelle innerhalb des Eingabebereichs stehen und mehrfach vorkommen.
• columns (all, selected, pkonly, removepk, orderby): vordefinierter Wert der angibt, welche Spalten durchlaufen werden sollen.
• Eingabebereich (– enter your code and available substitution variables here –): hier können Sie beliebigen Text, Code oder weitere Befehle einfügen, die für jede Spalte wiederholt wird. Normalerweise fügen Sie eine Spaltenvariable ein.

Beispiele

Für unsere folgenden Beispiele werden wir ein SQL SELECT Befehl schreiben und verwenden dazu eine Tabelle (tblTemplateGroups) mit 4 Spalten (siehe Bild unten).

Eingabebereich

Im Eingabebereich können Sie einfachen Text/Code und/oder weitere easy code generator Befehle eingeben. Im folgenden Beispiel geben wir nur den Text „test“ ein: {{<<columnsubstitution>><<crlf=false>><<delimiter=>><<columns=all>>test<<endcolumnsubstitution>>}}

Weil wir 4 Spalten verarbeiten, erhalten wir als Resultat 4 mal „test“: testtesttesttest

Wir können aber auch eine Spaltenvariable einfügen, z.B. den Spaltennamen <<columnName>>: {{<<columnsubstitution>><<crlf=false>><<delimiter=>><<columns=all>><<columnName>>
<<delimiter>><<endcolumnsubstitution>>}}

Nun erhalten wir folgendes Resultat: templateGroupIDdescriptionrecordInsertDaterecordUpdateDate

CRLF und Delimiter

Die oben genannten Beispiele machen natürlich wenig Sinn, sollen aber die grundsätzliche Funktionalität veranschaulichen.

Wenn wir crlf=true setzen, wird am Ende jeder Eingabe ein Zeilenumbruch hinzugefügt:
{{<<columnsubstitution>><<crlf=true>><<delimiter=>><<columns=all>><<columnName>>
<<delimiter>><<endcolumnsubstitution>>}}

Wir erhalten:
templateGroupID
description
recordInsertDate
recordUpdateDate

Und kombiniert mit einem Delimiter „,“:
{{<<columnsubstitution>><<crlf=true>><<delimiter=,>><<columns=all>><<columnName>>
<<delimiter>><<endcolumnsubstitution>>}}

templateGroupID,
description,
recordInsertDate,
recordUpdateDate

Bitte beachten Sie, dass wenn Sie einen Delimiter verwenden auch den Eintrag <<delimiter>> im Eingabebereich einsetzen. Sie können <<delimiter>> an jeder Stelle im Eingabebereich einsetzen und auch mehrfach verwenden.

Nun können wir schon den ersten Teil eines SELECT Befehls erzeugen. Vor dem Befehl schreiben wir SELECT und nach dem Befehl FROM… Beim delimiter setzen wir nach dem Komma noch ein Leerzeichen:
SELECT {{<<columnsubstitution>><<crlf=false>><<delimiter=, >><<columns=all>><<columnName>><<endcolumnsubstitution>>}} FROM…

SELECT templateGroupID, description, recordInsertDate, recordUpdateDate FROM…

Columns

Beim Parameter <<columns=>> geben Sie dem Befehl mit, welche Spalten Sie verarbeiten möchten. Sie haben folgende Möglichkeiten:

• all: verwendet alle Spalten der Tabelle
• selected: verwendet nur die Spalten, die Sie in der Spalte <Use> angekreuzt haben. Siehe Bild <Tabellen- und Spaltenauswahl>
• pkonly: verwendet nur die Primärschlüsselspalten. Siehe Bild <Tabellen- und Spaltenauswahl>, Spalte <P-Key>
• removepk: verwendet alle Spalten bis auf die Primärschlüsselspalten
• orderby: verwendet alle Spalten die als Order By angekreuzt wurden.
  Siehe Bild <Tabellen- und Spaltenauswahl>, Spalte <Order By>

Nun sind wir schon in der Lage einen kompletten SELECT Befehl zu schreiben. Als Tabellenname verwenden wir nicht einen fixen Text sondern die Systemvariable <<tableViewName>>

SELECT {{<<columnsubstitution>><<crlf=false>><<delimiter=, >><<columns=selected>><<columnName>><<delimiter>><<endcolumnsubstitution>>}} FROM {{<<systemvar>><<name=tableViewName>><<endsystemvar>>}} ORDER BY {{<<columnsubstitution>><<crlf=false>><<delimiter=, >><<columns=orderby>><<columnName>><<delimiter>><<endcolumnsubstitution>>}}

Wie Sie sehen, verwenden wir zwei <<columnsubstitution>> Befehle, eine für den SELECT Teil und den zweiten für den ORDER BY Teil. Im ersten Teil haben wir <<columns=selected>> verwendet und im zweiten Befehl
<<columns=orderby>>

In den weitere Hilfethemen werden Sie sehen, dass der <<columnsubstitution>> Befehl nicht nur für die Erstellung von SQL Befehlen verwendet wird. Mit diesem Befehl können wir ganze Variablendeklarationen in Klassen schreiben oder die abgefragten Werte aus der Datenbank den Variablen zuweisen.