4D Transformation Tags

Home

4D v15.4

4D bietet verschiedene Transformation Tags, um Referenzen auf 4D Variablen oder Ausdrücke einzufügen, oder verschiedene Vorgehensweisen innerhalb des Quelltextes, auch "template" genannt, auszuführen. Die Tags werden beim Ausführen des Quelltextes interpretiert und der Ausgabetext wird generiert.

Diese Funktionsweise nutzt der 4D Web Server zum Erzeugen von Halbdynamische Seiten.

Die Tags müssen in Form von HTML Kommentaren () in den Quellcode eingefügt werden. Aber auch Kommentare wie  sind möglich.

Es gibt folgende 4D Transformation Tags:

4DTEXT, um 4D Variablen und Ausdrücke als Text einzufügen,
4DHTML, um HTML Code einzufügen,
4DEVAL, um alle 4D Ausdrücke zu bewerten
4DSCRIPT, um eine 4D Methode auszuführen,
4DINCLUDE, um eine Seite in eine andere einzufügen,
4DBASE, um den Standardordner zu ändern, den das Tag 4DINCLUDE enthält,
4DIF, 4DELSE, 4DELSEIF und 4DENDIF, um logische Bedingungen in den Code mit Tags einzufügen,
4DLOOP und 4DENDLOOP, um Schleifen in den Code mit Tags einzufügen.

Es lassen sich auch verschiedene Tag Typen miteinander mischen. Hier ein Beispiel:

<HTML>
...
<BODY>
<!--#4DSCRIPT/PRE_PROCESS-->         (Method call)
<!--#4DIF (myvar=1)-->               (If condition)
   <!--#4DINCLUDE banner1.html-->   (Subpage insertion)
<!--#4DENDIF-->                     (End if)
<!--#4DIF (mtvar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLE]-->               (Loop on the current selection)
<!--#4DIF ([TABLE]ValNum>10)-->         (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpage.html-->   (Subpage insertion)
<!--#4DELSE-->                     (Else)
   <B>Value: <!--#4DTEXT [TABLE]ValNum--></B><BR>
                              (Field display)
<!--#4DENDIF-->
<!--#4DENDLOOP-->                  (End for)
</BODY>
</HTML>

Vorlagen ausführen

Der Inhalt von Vorlage Seiten lässt sich auf zwei Arten analysieren:

Über den Befehl PROCESS 4D TAGS: Er akzeptiert eine Vorlage als Eingabe, optional auch Parameter und gibt den Text als Ergebnis der Bearbeitung zurück.
Über den in 4D integrierten HTTP Server: Halbdynamische Seiten, die über die Befehle WEB SEND FILE (.htm, .html, .shtm, .shtml), WEB SEND BLOB (text/html vom Typ BLOB) oder WEB SEND TEXT gesendet oder über URL aufgerufen werden. Im letzten Fall werden zwecks Optimierung Seiten mit den Endungen .htm und .html NICHT analysiert. Um hier das Analysieren der HTML Seiten zu erzwingen, müssen Sie die Endung .shtm oder shtml anfügen, z.B. http://www.server.com/dir/page.shtm. Weitere Informationen dazu finden Sie im Abschnitt Halbdynamische Seiten des Kapitels Web Server.

4DTEXT

Syntax:  oder

Über  können Sie eine Referenz auf eine 4D Variable bzw. Ausdruck einfügen. Schreiben Sie zum Beispiel in einer HTML Seite:
<P>Welcome to !</P>,
wird der Wert der 4D Variablen vtSiteName in die HTML Seite eingefügt, wenn sie gesendet wird. Dieser Wert wird als einfacher Text eingefügt, spezifische HTML Zeichen wie ">" werden automatisch aufgelöst.

Über 4DTEXT können Sie auch einen 4D Ausdruck einfügen. So können Sie den Inhalt eines Feldes, z.B. ), ein Array Element, z.B. ) oder eine Methode, die einen Wert zurückgibt () direkt einfügen. Ein Ausdruck wird genauso wie eine Variable konvertiert. Ein 4D Ausdruck muss darüberhinaus auch die Syntaxregeln von 4D berücksichtigen.

Hinweis: Die Ausführung einer 4D Methode mit 4DTEXT aus einer Web Anfrage richtet sich nach der Option "Zugang per 4D Tags und URLs (4DACTION...)" im Dialogfenster Methodeneigenschaften. Weitere Informationen dazu finden Sie im Abschnitt Sicherheit der Verbindung.

Ein Ausdruck kann zwar direkt den Aufruf von 4D Funktionen enthalten, aus Gründen der Lokalisierung ist jedoch davon abzuraten. So interpretiert ein französisches 4D den Kommentar  korrekt, ein englisches 4D bearbeitet diesen Kommentar jedoch nicht. Dasselbe gilt für die Bearbeitung von Zahlen, da der Dezimaltrenner je nach Land variieren kann. In beiden Fällen raten wir dringend, über Programmierung eine Variable zuzuweisen.

Um sicherzustellen, dass Ausdrücke unabhängig von der 4D Programmiersprache oder Version korrekt bewertet werden, empfehlen wir die Syntax mit Tokens bei Elementen zu verwenden, deren Name sich zwischen verschiedenen Versionen ändern kann (Befehle, Tabellen, Felder, Konstanten). Um beispielsweise den Befehl Current time einzufügen, geben Sie 'Current time:C178' ein. Weitere Informationen dazu finden Sie im Abschnitt Tokens in Formeln verwenden.

Bei einem Bewertungsfehler erscheint der eingefügte Text in Form von “ : ## Fehler # Fehlercode”.

Hinweise:

Sie können mit Prozessvariablen arbeiten.
Aus Sicherheitsgründen empfehlen wir, dieses Tag beim Bearbeiten von Daten zu verwenden, die von außerhalb kommen, um das Einfügen von bösartigem Code zu vermeiden. Weitere Informationen dazu finden Sie unten im Abschnitt Anwendungshinweise.
Sie können den Inhalt eines Feldes vom Typ Bild anzeigen. Dagegen lässt sich der Inhalt eines Array-Elements vom Typ Bild nicht anzeigen.
Sie können den Inhalt eines Feldes vom Typ Objekt über eine 4D Formel anzeigen. Sie können z.B. schreiben .
In der Regel arbeiten Sie mit Textvariablen. Sie können aber auch Variablen vom Typ BLOB einsetzen. Dazu genügt es, das BLOB im Modus Text without length zu generieren.

4DHTML

Syntax:  oder

Über dieses Tag können Sie, wie beim Tag 4DTEXT, eine Variable oder einen 4D Ausdruck bewerten und in einen HTML Ausdruck einfügen. Dieser Tag löst jedoch NICHT spezielle HTML Zeichen auf. Hierzu ein Beispiel:

Wert von meinevar	Tags	Ergebnis
meinevar:="<B>"	<!--#4DTEXT meinevar-->	<B>
meinevar:="<B>"	<!--#4DHTML meinevar-->	<B>

Bei einem Bewertungsfehler erscheint der eingefügte Text in Form von “ : ## Fehler # Fehlercode”.

Hinweise:

Die Ausführung einer 4D Methode mit 4DHTML richtet sich nach der Option "Zugang per HTML Tags und URLs (4DAction...)" in den Methodeneigenschaften. Weitere Informationen dazu finden Sie im Abschnitt Sicherheit der Verbindung.
Aus Sicherheitsgründen empfehlen wir, das Tag 4DTEXT beim Bearbeiten von Daten zu verwenden, die von außerhalb kommen, um das Einfügen von bösartigem Code zu vermeiden. Weitere Informationen dazu finden Sie unten im Abschnitt Anwendungshinweise.

4DEVAL

Syntax:  oder 

Über das Tag 4DEVAL können Sie auf eine Variable oder einen 4D Ausdruck zugreifen. Wie 4DHTML löst auch 4DEVAL die HTML Zeichen im zurückgegebenen Text nicht auf. Im Gegensatz zu 4DHTML oder 4DTEXT kann 4DEVAL jedoch jede gültige 4D Anweisung ausführen, d.h. auch Anweisungen und Ausdrücke, die keinen Wert zurückgeben.

Sie können z.B. folgendes ausführen:

 $input:="<!--#4DEVAL a:=42-->" // Zuweisung ohne Ausgabe

 $input:=$input+"<!--#4DEVAL a+1-->" // Berechnung mit Ausgabe

 PROCESS 4D TAGS($input;$output)

  //$output = "43"

Bei fehlerhafter Interpretation wird der Text in Form von  : ## Fehler # Fehlernummer” eingefügt.

Hinweise:

Sie müssen im Dialogfenster Methode-Eigenschaften die Option "Zugang per 4D Tags und URLs (4DACTION...)" markieren, damit eine 4D Methode mit 4DEVAL über eine Web Anfrage ausführbar ist. Weitere Informationen dazu finden Sie im Abschnitt Sicherheit der Verbindung.
Aus Sicherheitsgründen empfehlen wir, das Tag 4DTEXT beim Bearbeiten von Daten zu verwenden, die von außerhalb kommen, um das Einfügen von bösartigem Code zu vermeiden. Weitere Informationen dazu finden Sie unten im Abschnitt Anwendungshinweise.

4DSCRIPT/

Syntax:

Mit 4DSCRIPT können Sie beim Bearbeiten des Template 4D Methoden ausführen. Existiert  als HTML Kommentar, wird die Methode MeineMeth mit dem Parameter MeinParam als ein String in $1 ausgeführt. Wird das Tag im Rahmen eines Web Prozesses beim Laden der Seite aufgerufen, ruft 4D – sofern vorhanden – die Datenbankmethode On Web Authentication auf. Gibt diese Wahr zurück, führt 4D die Methode aus.

Die Methode muss in $0 Text zurückgeben. Beginnt der String mit dem Zeichencode 1, wird er als HTML betrachtet. Dasselbe Prinzip gilt auch für das Tag 4DHTML.

Hinweis: Die Ausführung einer Methode mit 4DSCRIPT richtet sich nach der Option "Zugang per HTML Tags und URLs (4DAction...)", die im Dialogfenster Methodeneigenschaften definiert wird. Weitere Informationen dazu finden Sie im Abschnitt Sicherheit der Verbindung.

Der Inhalt der Seite wird analysiert, wenn der Befehl WEB SEND FILE (.htm, .html, .shtm, .shtml) oder WEB SEND BLOB (blob vom Typ Text/html) aufgerufen wird.
Beachten Sie, dass die Analyse im nicht kontextuellen Modus auch erfolgt, wenn eine URL auf eine Datei mit der Endung “.shtm” oder “.shtml” zeigt, zum Beispiel http://www.server.com/dir/page.shtm).

Fügen Sie zum Beispiel den Kommentar “heute ist der ” in eine statische Seite ein. Beim Laden der Seite ruft 4D –sofern vorhanden– die Datenbankmethode On Web Authentication auf, dann die Methode MeineMeth und übergibt den String “/MeinParam” als Parameter $1.

Die Methode gibt in $0 Text zurück, zum Beispiel “31.12.09”, der Ausdruck “heute ist der <!--4DSCRIPT/MeineMeth/MeinParam––>” also zu “Heute ist der 31.12.09”.

Die Methode MeineMeth lautet:

 C_TEXT($0)\\Dieser Parameter muss immer angegeben sein

 C_TEXT($1)\\Dieser Parameter muss immer angegeben sein

 $0:=String(Current date)

Wichtig: Sie müssen in der aufgerufenen Methode immer die Parameter $0 und $1 angeben.

Hinweis: Eine Methode, die über 4DSCRIPT aufgerufen wird, darf keine Elemente der Oberfläche aufrufen, wie DIALOG, ALERT... .

Da 4D Methoden in ihrer eigenen Reihenfolge erscheinen, lässt sich eine Methode aufrufen, die den Wert von vielen Variablen setzt, auf die später im Dokument verwiesen wird. Sie können in ein Template beliebig viele  Kommentare einfügen.

4DINCLUDE

Syntax:

Dieses Tag dient hauptsächlich dazu, um in eine HTML Seite den Hauptteil einer anderen HTML Seite einzufügen (angegeben im Parameter Pfad). Als Hauptteil einer HTML Seite gilt alles, was innerhalb der Ausdrücke <body> und </body> steht. Die Tags selbst werden nicht eingefügt. Auf diese Weise können Sie Konflikte mit den im Header enthaltenen Meta Tags vermeiden. Enthält die angegebene HTML Seite keine Tags <body> </body>, wird die komplette Seite integriert. Sie müssen selbst für die Konsistenz der Meta Tags sorgen.
Der Kommentar  ist besonders hilfreich in Verbindung mit dem Test () oder den Schleifen (). Er ist auch praktisch, um Tags nach einem bestimmten Kriterium oder zufällig einzufügen.
4D analysiert die aufgerufene Seite im Moment des Einfügens, unabhängig von der Endung des Dateinamens, und fügt dann den evtl. geänderten Inhalt in die Seite ein, von der der Aufruf 4DINCLUDE ausgeht.

Eine Seite, die über den Kommentar  eingefügt wurde, wird im Web Cache genauso gesetzt wie die Seiten, die über eine URL angefordert oder über den Befehl WEB SEND FILE gesendet wurden.
In Pfad übergeben Sie den Zugriffspfad des einzufügenden Dokuments. Beachten Sie, dass sich der Pfad bei Aufrufen mit 4DINCLUDE nach dem Dokument richtet, das gerade analysiert wird, d.h. nach dem Hauptdokument. Verwenden Sie den Schrägstrich (/) als Trenner zwischen den Dokumenten und die zwei Punkte (..), um in der Hierarchie eine Ebene höher zu gehen (HTML Syntax).

Hinweise:

Verwenden Sie das Tag 4DINCLUDE mit dem Befehl PROCESS 4D TAGS, ist der Standardordner der Ordner mit der Strukturdatei der Anwendung.
Mit  können Sie den Standardordner, den 4DINCLUDE in der aktuellen Seite verwendet, verändern (siehe unten)

Sie können  innerhalb einer Seite beliebig oft verwenden. Die Aufrufe von  sind jedoch nur auf einer Ebene möglich. Sie können also nicht den Kommentar  in den Hauptteil der Seite meindok2.html einfügen, die wiederum von  aufgerufen wird, welches in meindok1.html eingefügt ist. 4D prüft außerdem, dass die Einfügungen nicht rekursiv sind.

Bei einem Fehler erscheint der eingefügte Text in Form von ": Dokument kann nicht geöffnet werden".

Beispiele

<!--#4DINCLUDE Unterseite.html-->
<!--#4DINCLUDE Ordner/Unterseite.html-->
<!--#4DINCLUDE ../Ordner/Unterseite.html-->

4DBASE

Syntax:

Das Tag  bezeichnet ein Arbeitsverzeichnis, das vom Tag  verwendet wird.
Beim Aufrufen in einer Web Seite ändert das Tag  alle nachfolgenden Aufrufe von  auf dieser Seite bis zum nächsten  - sofern vorhanden. Wird der Ordner  aus einer enthaltenden Datei heraus geändert, findet er deren ursprünglichen Wert aus der übergeordneten Datei.

Der Parameter folderPath muss einen Pfad relativ zur aktuellen Seite enthalten und dieser muss mit einen Schrägstrich (/) enden. Der angegebene Ordner muss innerhalb des Web Ordners liegen.
Übergeben Sie das Schlüsselwort WEBFOLDER, um den Standardpfad, d.h. relativ zur Seite, wiederherzustellen.

Der folgende Code aus 4D v12, der für jeden Aufruf einen relativen Pfad angibt:

<!--#4DINCLUDE subpage.html--> 
<!--#4DINCLUDE folder/subpage1.html-->
<!--#4DINCLUDE folder/subpage2.html-->
<!--#4DINCLUDE folder/subpage3.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

... lässt sich mit dem Tag  schreiben wie folgt:

<!--#4DINCLUDE subpage.html--> 
<!--#4DBASE folder/-->
<!--#4DINCLUDE subpage1.html-->
<!--#4DINCLUDE subpage2.html-->
<!--#4DINCLUDE subpage3.html-->
<!--#4DBASE ../folder/-->
<!--#4DINCLUDE subpage.html-->
<!--#4DBASE WEBFOLDER-->

Beispiel

Verzeichnis für die Home Page über das Tag  erstellen:

/* Index.html */
<!--#4DIF LangFR=True-->
    <!--#4DBASE FR/-->
<!--#4DELSE-->
    <!--#4DBASE US/-->
<!--#4DENDIF-->
<!--#4DINCLUDE head.html-->
<!--#4DINCLUDE body.html-->
<!--#4DINCLUDE footer.html-->

In der Datei Head.html wird der aktuelle Ordner durch  geändert, ohne dass sich sein Wert in Index.htm ändert:

/* Head.htm */
/* das Arbeitsverzeichnis hier ist relativ zur enthaltenen Datei (FR/ oder US/) */
<!--#4DBASE Styles/-->
<!--#4DINCLUDE main.css-->
<!--#4DINCLUDE product.css-->
<!--#4DBASE Scripts/-->
<!--#4DINCLUDE main.js-->
<!--#4DINCLUDE product.js-->

4DIF, 4DELSE, 4DELSEIF und 4DENDIF

Syntax:  {...} {}

Der Kommentar  ermöglicht in Verbindung mit den Kommentaren  (optional) und , Teile des Code auf bedingte Weise auszuführen.
Der Parameter expression kann jeden gültigen 4D Ausdruck enthalten, der einen booleschen Wert zurückgibt. Er muss in Klammern stehen und die Syntaxregeln von 4D berücksichtigen.

Die Blöcke  können ineinander verschachtelt sein. Analog zu 4D muss jeder mit  geöffnete Kommentar mit  geschlossen werden.

Bei einem Interpretationsfehler wird zwischen  und  anstelle des Inhalts der Text “: Ein boolescher Ausdruck wurde erwartet” eingefügt.
Entspricht nicht jedem <!-#-4DENDIF--> ein , wird anstelle des Inhalts der Text
“: 4DENDIF wurde erwartet” eingefügt.

Über das Tag  können Sie eine unbegrenzte Anzahl von Bedingungen testen. Nur der Code, der auf die erste als Wahr gewertete Bedingung folgt, wird ausgeführt. Ist keine der Bedingungen wahr, wird keine Anweisung ausgeführt (wenn es kein abschließendes  gibt).
Sie können nach dem letzten Tag  ein Tag  verwenden. Sind alle Bedingungen falsch, werden die Anweisungen ausgeführt, die auf  folgen.

Die beiden nachfolgenden Codes sind gleichwertig:

Code nur mit 4DELSE:

<!--#4DIF Condition1-->
  /* Condition1 ist wahr*/
<!--#4DELSE-->
    <!--#4DIF Condition2-->
        /* Condition2 ist wahr*/
    <!--#4DELSE-->
        <!--#4DIF Condition3-->
            /* Condition3 ist wahr*/
        <!--#4DELSE-->
            /*Keine der Bedingungen ist wahr*/
        <!--#4DENDIF-->
    <!--#4DENDIF-->
<!--#4DENDIF-->

Ähnlicher Code mit dem Tag 4DELSEIF:

<!--#4DIF Condition1-->
     /* Condition1 ist wahr*/
<!--#4DELSEIF Condition2-->
     /* Condition2 ist wahr*/
<!--#4DELSEIF Condition3-->
    /* Condition3 ist wahr*/
<!--#4DELSE-->
    /* Keine der Bedingungen ist wahr*/
<!--#4DENDIF-->

Beispiel 1

Dieses Beispiel fügt je nach angemeldetem Benutzer unterschiedliche Seiten ein:

<!--#4DIF LoggedIn=False-->
    <!--#4DINCLUDE Login.htm -->
<!--#4DELSEIF User="Admin" -->
    <!--#4DINCLUDE AdminPanel.htm -->
<!--#4DELSEIF User="Manager" -->
    <!--#4DINCLUDE SalesDashboard.htm -->
<!--#4DELSE-->
    <!--#4DINCLUDE ItemList.htm -->
<!--#4DENDIF-->

Beispiel 2

Nachfolgendes Beispiel zeigt Code aus einer statischen HTML Seite, die je nach Ergebnis des Ausdrucks vname#"" eine andere Bezeichnung zeigt:

<BODY>
...
<!--#4DIF (vname#"")-->
Namen, die mit <!--#4DTEXT vname--> beginnen.
<!--#4DELSE-->
Es wurde kein Name gefunden.
<!--#4DENDIF-->
...
</BODY>

4DLOOP und 4DENDLOOP

Syntax:

Mit diesem Kommentar können Sie den Teil eines HTML Codes so oft wiederholen wie die Bedingung erfüllt ist. Der Teil wird begrenzt durch  und . Sie können ineinander verschachtelt sein. Analog zu 4D muss jeder mit  geöffnete Kommentar mit  geschlossen werden.

Es gibt fünf Bedingungstypen:


Diese Syntax führt für jeden Datensatz der aktuellen Auswahl von Tabelle eine Schleife im laufenden Prozess aus. Der Teil des HTML Codes zwischen den beiden Kommentaren wird für jeden Datensatz der aktuellen Auswahl wiederholt.

Hinweis: Wird ein Tag 4DLOOP mit einer Tabelle verwendet, werden die Datensätze im Nur-Lesen Modus geladen.

Dieser Code:

<!--#4DLOOP [People]-->
<!--#4DTEXT [People]Name--> <!--#4DTEXT [People]Surname--><BR>
<!--#4DENDLOOP-->

... lässt sich in 4D Code folgendermaßen ausdrücken:

 FIRST RECORD([People])

 While(Not(End selection([People])))

    ...

    NEXT RECORD([People])

 End while


Diese Syntax führt für jedes Element des Array eine Schleife aus. Der laufende Zähler des Array erhöht sich mit jeder Wiederholung dieses Teils des HTML Codes.

Hinweis: Diese Syntax ist für zweidimensionale Arrays nicht verwendbar. Die Lösung: eine Methode mit verschachtelten Schleifen kombinieren.

Dieser Code:

<!--#4DLOOP arr_names-->
<!--#4DTEXT arr_names{arr_names}--><BR>
<!--#4DENDLOOP-->

... lässt sich folgendermaßen in 4D Code übersetzen:

 For($Elem;1;Size of array(arr_names))

    arr_names:=$Elem

    ...

 End for


Diese Syntax führt eine Schleife aus, solange die Methode Wahr zurückgibt. Sie lässt einen Parameter vom Typ Lange Ganzzahl zu. Sie wird das erste Mal mit dem Wert 0 (Null) aufgerufen, damit evtl. eine Initialisierung durchgeführt werden kann. Dann wird sie sukzessiv mit den Werten 1, 2, 3... aufgerufen, solange sie Wahr zurückgibt.

Aus Sicherheitsgründen kann die Datenbankmethode On Web Authentication einmal direkt vor der Initialisierung aufgerufen werden. Wird die Authentifizierung bestätigt, findet die Initialisierungsphase statt.

Warnung: Damit die Datenbank kompilierbar ist, müssen innerhalb der Methode unbedingt die Compilerbefehle C_BOOLEAN($0) und C_LONGINT($1) deklariert sein.

Dieser Code:

<!--#4DLOOP meine_methode-->
<!--#4DTEXT var--> <BR>
<!--#4DENDLOOP-->

... lässt sich folgendermaßen in 4D Code übersetzen:

 If(AuthenticationWebOK)

    If(meine_methode(0))

       $counter:=1

       While(meine_methode($counter))

          ...

          $counter:=$counter+1

       End while

    End if

 End if

Die Methode meine_methode lautet:

 C_LONGINT($1)

 C_BOOLEAN($0)

 If($1=0)

  `Initialisierung

    $0:=True

 Else

    If($1<50)

       ...

       var:=...

       $0:=True

    Else

       $0:=False `Stoppt die Schleife

    End if

 End if


Mit dieser Syntax führt das Tag 4DLOOP eine Schleife aus, solange der 4D Ausdruck Wahr zurückgibt. Das kann jeder gültige Boolean Ausdruck sein und dieser sollte in jeder Schleife einen variablen Part zur Bewertung haben, um unendliche Schleifen zu vermeiden.

Dieser Code:

<!--#4DEVAL $i:=0-->
<!--#4DLOOP ($i<4)-->
<!--#4DEVAL $i-->
<!--#4DEVAL $i:=$i+1-->
<!--#4DENDLOOP-->

ergibt folgendes:


In diesem Fall arbeitet das Tag 4DLOOP wie mit einem Array, d.h. es macht für jeden Eintrag im Array eine Schleife. Der aktuelle Eintrag des Array erhöht sich, wenn dieser Part im Code wiederholt wird.

Diese Syntax ist hilfreich, wenn Sie im Befehl PROCESS 4D TAGS als Parameter einen Array Zeiger übergeben.

Beispiel:

 ARRAY TEXT($array;2)

 $array{1}:="hello"

 $array{2}:="world"

 $input:="<!--#4DEVAL $1-->"

 $input:=$input+"<!--#4DLOOP $2-->"

 $input:=$input+"<!--#4DEVAL $2->{$2->}--> "

 $input:=$input+"<!--#4DENDLOOP-->"

 PROCESS 4D TAGS($input;$output;"elements = ";->$array)

  // $output = "elements = hello world"

Bei einem Interpretationsfehler wird zwischen  und  der Text “:Beschreibung” eingefügt.

Folgende Fehlerbeschreibungen sind möglich:

Ein derartiger Ausdruck wurde nicht erwartet (generischer Fehler);
Ungültiger Tabellenname (Fehler im Tabellennamen);
Es wurde ein Array erwartet (die Variable ist kein Array bzw. ein zweidimensionales Array).
Die Methode existiert nicht;
Syntaxfehler (beim Ausführen der Methode);
Zugriffsfehler (Rechte nicht ausreichend für Zugriff auf Tabelle oder Methode).
4DENDLOOP wird erwartet (die Anzahl von  passt nicht zur Anzahl von ).

Anwendungshinweise

Rekursive Durchführung

4D Tags werden rekursiv interpretiert: 4D versucht immer, das Ergebnis einer Transformation wieder zu interpretieren. Wenn eine neue Transformation stattgefunden hat, wird eine zusätzliche Interpretation durchgeführt und weitergeführt, bis das erhaltene Produkt keine weitere Transformation benötigt. Nehmen wir z.B. folgende Anweisung:

<!--#4DHTML [Mail]Letter_type-->

Enthält das Textfeld [Mail]Letter_type selbst ein Tag, z.B. , wird dieses Tag nach der Interpretation des 4DHTML Tag rekursiv bewertet.

Dieses Vorgehen erfüllt die meisten Anforderungen an Texttransformation. Beachten Sie jedoch, dass dies in manchen Fällen zum Einfügen von böswilligem Code führen kann.

Einfügen von böswilligem Code verhindern

4D Transformation Tags akzeptieren verschiedene Datentypen als Parameter: Text, Variablen, Methoden, Befehlsnamen, etc. Stammen diese Daten von Ihrem eigenen Code, besteht kein Risiko, dass böswilliger Code eingefügt wird, da Sie die Eingabe steuern. Jedoch arbeitet Ihr Datenbank Code oft mit Daten, die zu irgendeinem Zeitpunkt über eine externe Quelle dazugekommen sind, wie Benutzereingabe, Import, etc.
In diesem Fall raten wir, keine Transformation Tags wie 4DEVAL oder 4DSCRIPT zu verwenden, da sie die Parameter direkt mit dieser Art Daten bewerten.
Außerdem kann durch die rekursive Vorgehensweise (siehe voriger Abschnitt) böswilliger Code selbst Transformation Tags enthalten. Hier MUSS der Tag 4DTEXT verwendet werden.
Nehmen wir z.B. ein Feld im Webformular genannt "Name", in das Benutzer ihren Namen eingeben müssen. Dieser Name wird dann über ein Tag  auf der Seite angezeigt. Wird stattdessen Text vom Typ "" eingefügt, führt die Interpretation dieses Tags zum Beenden der Anwendung.
Um dieses Risiko zu vermeiden, verwenden Sie einfach für solche Fälle systematisch das Tag 4DTEXT. Da dieses Tag die speziellen HTML Zeichen schützt, wird evtl. eingefügter böswilliger Code nicht erneut interpretiert. Das bedeutet für obiges Beispiel: Das Feld "Name" enthält in diesem Fall "" es wird nicht transformiert.

Siehe auch

4D Objekte mit HTML Objekten verbinden
Halbdynamische Seiten
PROCESS 4D TAGS
URLs und Form Actions