| home -> documentation -> language reference -> REDIRECT tag |
|
Description
The REDIRECT tag is used to interrupt the current page interpretation and jump into the new page specified.
Syntax
<#REDIRECT [EXPRESSION=""] DOC="document" | URL="anURL"/>
|
|
| EXPRESSION |
You could specify in the EXPRESSION property a Boolean expression and the REDIRECT tag will become conditional, which means that the redirection will be executed if and only if the Boolean expression evaluates to true. |
| DOC |
Specify in the DOC property the document that will be displayed instead of the actual one. This property is primarily intended for DBSP documents. |
| URL |
Specify in the DOC property a document that is outside of the current site or server. If this property is specified, the redirection will act as an HTML redirect. |
|
Note: All the code interpreted before the REDIRECT tag will be discarded and substituted by the content located in the new page. However, all the database modifications made with the DATASET or QRYEXEC tag before the redirection will not be discarded (in the database context, will not be rolled back).
|
Examples
Example 1. A simple redirection
This example shows an unconditional redirection.
Source code
File: examples/Ex7_5_1.dbsp
<h1>Unconditional redirection</h1> <p>All this code will be ignored and the redirection page will be displayed instead.</p> <p>However, any modification to the database made here using the DATASET or QRYEXEC tag will be executed.</p> <#REDIRECT DOC="Ex7_5_1a.dbsp"/>
|
File: examples/Ex7_5_1a.dbsp
<html> <body> <h1>A simple redirection</h1> <hr> <p>This page has been redirected.</p> </body> </html>
|
Test example
Example 2. Conditional redirection.
In this example, the application displays the correct page according the user profile.
Source code
File: examples/Ex7_5_2.dbsp
<html> <body> <h1>Conditional redirection</h1> <hr> <p>Select your user profile:</p> <form name="frmProfile" method="post" action="Ex7_5_2a.dbsp"> <input type="radio" name="Profile" value="adm">Administrator<br> <input type="radio" name="Profile" value="usr">Normal user<br><br> <button type="submit">Select</button> </form> </body> </html>
|
File: examples/Ex7_5_2a.dbsp
<html> <#REDIRECT EXPRESSION="profile='adm'" DOC="Ex7_5_2b.dbsp"/> <body> <h1>User profile</h1> <hr> <p>The normal user profile was selected.</p> <p><button onclick="javascript:history.back()">Back</button></p> </body> </html>
|
Test example
|