Die Antwort auf den Request

Die von der SAJAX-Funktion zusammengestellte URL ruft den VIO.Matrix CIS auf. In dem Request integriert ist der Aufruf des Layouts "sajax_response". Dieses übernimmt die Verarbeitung des Requests auf Serverseite und sieht folgendermaßen aus:

In der SP-Variable "rsarg0" steht der Name des in Schritt 3 dieses Tutorials zu sehenden Layouts "sajax_content". Dieses Layout nimmt den Request (der in der SP-Variable "rsarg1" steht) auseinander, teilt ihn (in weiteren Unterlayouts anhand des schon genannten Platzhalters *SPLT*) mittels #SPLIT so, dass alle übergebenen Parameter als Variablen mit vorangestelltem "sajax_" vorliegen.

Wird also beim Beispiel der viomatrix.de-Suche "search=suchtext" als Parameter übergeben entsteht auf Serverseite die Variable "sajax_search" mit dem Wert "suchtext".

Auch in dem Request integriert ist der Name des Anfangs genannten Layouts, welches die Antwort auf den Request zusammenstellen soll. Dieser Name sollte in einer Variable, z.B. "aufzurufendeFunktion" gespeichert werden. Dieses Layout wird nun nach Ermittlung aller Variablen ausgeführt.

Dieses Layout muss zwingend jeglichen Inhalt den es zurückgeben will an die Variable "ajax" übergeben. Die Variable ist bereits im obersten Beispiel in diesem Tutorial-Schritt zu sehen.

Die Antwort auf einen AJAX-Request muss einzeilig und ohne Leerzeichen oder Tabulator beginnen - andernfalls gibt es einen Fehler.

Demzufolge könnte ein Layout für eine derartig formatierte Antwort z.B. so aussehen:

Davor und dahinter können beliebige weitere VIO.Matrix-Platzhalter eingefügt werden. WIchtig ist nur, dass das was zurückgegeben wird auch in der Variable "ajax" steht.

Da der VIO.Matrix CIS das aufgerufene Layout wie bei jedem Aufruf eines Layouts an das aufrufende Programm zurück gibt muss man hier nun nichts weiter konfigurieren. Würde man den Request direkt im Browser aufrufen sähe die Ausgabe z.B. so aus:

wobei diese im Einzelnen bedeutet:

• "ok" -> AJAX-Bestandteil zur Ermittlung, ob ein Request funktioniert hat
• "searchform" -> Name des Objektes in den der Inhalt eingetragen werden soll
• alles hinter "|" -> ist der einzutragende Inhalt

Hinweis: wie man oben sieht sollte kein "|" im zurückgegebenen Inhalt enthalten sein. Andernfalls würde die Einbindung der Antwort in die Webseite nicht funktionieren. Statt dem "|" sollte man dessen HTML-Kodierung | (hexadezimal) oder | (dezimal) verwenden die mit VIO.Matrix auch über die Codecs hexhtml und dechtml formatiert werden können.

Die Antwort auf den AJAX-Request geht zurück an die aufrufende JavaScript-Funktion "sajax_do_call()", welche drauf die Antwort in dem ursprünglich angegebenen Objekt ausgibt.

weiter