In diesem Abschnitt werden die in der SQL-Vorlage enthaltenen Felder erklärt. In Beispiele für Vorlagen finden Sie Beispiele für die Verwendung dieser Felder.

Tabelle 1-1: SQL-Vorlagenfelder

Feldname Beschreibung
#
Die Vorlagennummer. In diesem Feld wird der Verweis angezeigt, der verwendet wird, um eine Vorlage in die primäre SQL-Abfrage einzufügen. Verwenden Sie die Tilde (~) zusammen mit der Vorlagennummer, um anzugeben, wo die Vorlage eingefügt werden soll. Beispiel: ~1 gibt an, wo Vorlage 1 eingefügt werden soll, sofern bestimmte Bedingungen erfüllt sind. Beachten Sie, dass die Vorlage am Ende der SQL-Anweisung eingefügt wird, wenn kein Vorlagenverweis in der SQL-Abfrage gefunden wurde.
Auto-Where
Wenn Sie dieses Kontrollkästchen aktivieren, wird das korrekte Filterwort (WHERE, AND oder OR) automatisch zum Anfang einer Vorlage hinzugefügt. Dies ist nützlich, wenn keine WHERE-Klausel in der SQL-Hauptanweisung vorhanden ist und die Einfügereihenfolge der Vorlagen nicht bekannt ist. Diese Option verwendet immer WHERE für die erste hinzuzufügende Vorlage und dann entweder AND oder OR, je nachdem, welches dieser Wörter für die einzelnen nachfolgenden Vorlagen in der ursprünglichen Vorlagenquelle vorhanden sind. Wenn die Vorlagenquelle keines dieser Wörter enthält, lautet der Standardwert entweder WHERE oder AND. Die einfachste Methode zum Verwenden dieser Funktion besteht darin, entweder OR oder AND als erstes Wort in der Vorlagenquelle zu platzieren. Danach ersetzt diese Funktion dieses Wort mit WHERE, wenn die Vorlage als erste in die SQL-Anweisung eingefügt werden soll.
Weitere Informationen finden Sie unter Dynamisches Filtern mit der Auto-Where-Funktion. Beispiele zur Verwendung der Auto-Where-Option finden Sie unter Eine Vorlage mit einer abweichenden Eingabe wiederverwenden und Eine Vorlage mit mehreren abweichenden Eingaben wiederverwenden.
SQL-Quelle
In diesem Feld wird der Inhalt der Vorlage definiert, der optional zum SQL hinzugefügt wird. Die Quelle kann normale Parameter in der folgenden Form aufweisen: %1, %2 sowie Markierungen im Format #1, #2 umfassen, die zusammen mit dem URL-Parameter IF einschließen verwendet werden, der in dieser Tabelle in der Zeile IF einschließen sowie in IF einschließen beschrieben wird.
Auto-Comma
Mit diesem Kontrollkästchen können Sie dafür sorgen, dass alle kommagetrennten Variablen nach ihrer Auflösung die richtige Anzahl von Kommas enthalten. Beispiele für kommagetrennte Variablen sind unter anderem %1, %2 und %3. Beispiel: Wenn %2 in eine leere Zeichenfolge aufgelöst wird, wird die Liste automatisch konvertiert, um alle leeren Kommas zu entfernen. Daher wird 12,,24 umgewandelt zu 12,24. Beachten Sie, dass die Syntax der ursprünglichen Liste korrekt sein muss.
Weitere Informationen finden Sie unter Die Auto-Comma-Funktion verwenden. Beispiele zur Verwendung der Auto-Comma-Option finden Sie unter Eine Vorlage einschließen, wenn einer der Parameter nicht leer ist. und Anzeigeverhalten für die Bedingung: Nicht alle Eingaben gesetzt auf Flag.
IF einschließen
Die Bedingungen für den Einschluss von Vorlagen werden über diese Option ausgewählt. Für die Beschreibungen in den folgenden Themen bezieht sich der Begriff Benutzereingabe auf alle Parameter, die im Format &inputlabel1=Daten an den LiveReport übergeben wurden. Viele der Vorlagenbedingungen sind abhängig von den Inhalten einer oder mehrerer diese Benutzereingaben. Die Benutzereingaben können innerhalb der Vorlagenquelle flexibel verwendet werden.
Weitere Informationen zu den verfügbaren Bedingungen für die Liste IF einschließen finden Sie unter IF einschließen.

IF einschließen

Die Liste IF einschließen enthält die folgenden Optionen:

  • Obligatorisch (keine Bedingung): Bei Auswahl dieser Option wird die Vorlage immer eingefügt. Diese Option ist nützlich, um die SQL-Anweisung in kleinere Teile aufzuteilen.

  • URL-Parameter: Mit dieser Option wird festgelegt, dass diese Vorlage eingefügt wird, wenn ein benannter Parameter in der URL gefunden wird. Wenn Sie diese Option auswählen, wird das Textfeld Parametername angezeigt. Über dieses Feld wird der Name des URL-Parameters festgelegt, der den Einschluss der Vorlage bewirkt. Mit diesem Parameter in der URL kann außerdem festgelegt werden, welche Benutzereingaben in die Vorlage eingefügt werden, wenn Markierungen im Format #1 in der Vorlagenquelle verwendet wurden. Mit diesen Markierungen wird festgelegt, wo die einzelnen Benutzereingaben in der Quelle eingefügt werden. Eine Vorlage könnte beispielsweise durch einen URL-Parameter in folgendem Format aktiviert (eingeschlossen) werden: &addtemplate=U2,U3. Auf diese Weise wird eine Liste von Benutzereingaben festgelegt, die von dieser Vorlage verwendet werden können. Jedes Objekt in dieser Liste steht für eine Benutzereingabe. Z. B. U2 = USERINPUT 2. Die vom ersten Objekt in der Liste festgelegte Benutzereingabe wird anstelle der Markierung 1 (#1) festgelegt. In diesem Beispiel wird #1 vom Wert &inputlabel2 ersetzt. Das zweite Objekt verweist auf U3, das heißt, der Wert &inputlabel3 ersetzt Markierung 2 (#2). Später in diesem Dokument wird diese abstrakte Darstellung anhand mehrerer Beispiele konkretisiert. Beachten Sie, dass der URL-Parameter mindestens genauso viele Benutzereingaben angeben muss wie in der Vorlagenquelle vorhanden sind, damit die Quelle eingeschlossen wird.

    Beispiele finden Sie unter Einfügen von Vorlagen mit URL-Parametern steuern.

  • Keine Eingaben gesetzt auf Flag: Mit dieser Option wird festgelegt, dass der Einschluss dieser Vorlage von den Einstellungen derjenigen Benutzereingaben abhängt, die mit dem üblichen Parameterformat in der Vorlagenquelle verwendet werden. Zum Beispiel „%1“. Wenn Sie diese Option auswählen, wird das Feld Flagwert angezeigt. Über dieses Feld wird festgelegt, welcher Wert in übergebenen Benutzereingaben als Flag verwendet wird. Der häufigste verwendete Wert ist eine leere Zeichenfolge; andere wahrscheinliche Beispiele sind jedoch keine und alle. Über diese Option wird festgelegt, dass die Vorlage nur dann eingeschlossen wird, wenn keine der Benutzereingaben auf das angegebene Flag gesetzt ist. Wenn eine Vorlage beispielsweise in zwei Eingabeparametern verwendet wird, von denen einer auf eine leere Zeichenfolge eingestellt ist, wird die Vorlage nicht eingeschlossen.

    Beispiele finden Sie unter Einfügen von Vorlagen über Werte von Benutzereingaben steuern.

  • Nicht alle Eingaben gesetzt auf Flag: Diese Option gleicht der zuvor beschriebenen Option. Allerdings wird die Vorlage bei Auswahl dieser Option eingeschlossen, es sei denn, alle verwendeten Eingabewerte werden auf das festgelegte Flag gesetzt. Ist der Flagwert beispielsweise leer (als leere Zeichenfolge betrachtet) und in der Vorlage werden zwei Benutzereingaben verwendet, wird die Vorlage eingeschlossen, es sei denn, es handelt sich bei beiden Eingaben um eine leere Eingabe.

    Beispiele finden Sie unter Einfügen von Vorlagen über Werte von Benutzereingaben steuern.

  • Vorlagebedingung wahr: Wurde diese Option ausgewählt, hängt der Einschluss der Vorlage davon ab, ob eine weitere Vorlage mit „true“ bewertet wird oder nicht. Die Option Vorlagennummer legt fest, welche Bedingung der vorherigen Vorlage verwendet wird. Mit der Vorlagennummer 2 wird die Vorlage, für die diese Option eingestellt ist, nur dann eingeschlossen, wenn Vorlage 2 als wahr ausgewertet wird.

    Diese Bedingung ist nützlich, wenn Teile der SQL-Anweisung auf Grundlage derselben Bedingung in verschiedenen Teile der primären SQL-Quelle eingefügt werden sollen. Einer der SQL-Teile kann die eigentlichen Bedingungen besitzen, die für den Einschluss definiert wurden, während die anderen Teile nur Vorlagebedingung wahr verwenden, um auf die andere Vorlage zu verweisen.

    Ein Beispiel für diese Bedingung finden Sie unter Zwei Vorlagen auf Grundlage einer einzelnen Bedingung hinzufügen.

  • Vorlagebedingung falsch: Wurde diese Option ausgewählt, hängt der Einschluss der Vorlage davon ab, ob eine weitere Vorlage mit „false“ bewertet wird oder nicht. Das Feld Vorlagennummer legt fest, welche Bedingung der vorigen Vorlage verwendet wird. Mit der Vorlagennummer 2 wird diese Vorlage nur dann eingeschlossen, wenn Vorlage 2 als falsch ausgewertet wird.

    Diese Option ist nützlich, wenn zwei Vorlagen vorhanden sind, die sich gegenseitig ausschließen. Durch die Verwendung dieser Bedingung muss kein entsprechender Bedingungssatz ausgearbeitet werden, damit eine Vorlage nur bei Ausschluss der jeweils anderen eingeschlossen wird. Ein Beispiel für diese Bedingung finden Sie unter Eine Vorlage einschließen, wenn einer der Parameter nicht leer ist..