docs.roxen.comView this page in a printer friendly mode
DocsRoxenWebServer 5.1Web Developer ManualVariable Tags
Copyright  2013, Roxen Internet Software
Suggestions, comments & compliments
manuals@roxen.com
 DEMO  DOCS  PIKE
 COMMUNITY  DOWNLOAD
www.roxen.com



<append>
<copy-scope>
<dec>
<define>
<elements>
<inc>
<insert>
<insert cached-href>
<insert file>
<insert href>
<insert realfile>
<insert scopes>
<insert variable>
<insert variables>
<roxen-automatic-charset-variable>
<range>
<scope>
<set>
<sprintf>
<sscanf>
<undefine>
<unset>
<use>
<value>
<vform>

<insert href/>

Provided by module: Tags: Additional RXML tags

Inserts the contents at that URL. This function has to be enabled in the Additional RXML tags module in the Roxen WebServer configuration interface. The page download will block the current thread, and if running unthreaded, the whole server.

Note: Requests are made in HTTP/1.0.


Attributes

href="string"

The URL to the page that should be inserted.


nocache="string"

If provided the resulting page will get a zero cache time in the RAM cache. The default time is up to 60 seconds depending on the cache limit imposed by other RXML tags on the same page.


method="string"(GET)

Method to use when requesting the page. GET or POST.


silent="string"

Do not print any error messages.


status-variable="variable"

Prints the return code for the request in the specified varible.

<insert href='http://www.somesite.com/news/' status-variable='var.status-code' />

timeout="int"

Timeout for the request in seconds. This is not available if your run the server without threads.

<insert href='http://www.somesite.com/news/' silent='silent' timeout='10' /> <else> Site did not respond within 10 seconds. Try again later. </else>

post-variables=""variable=rxml variable[,variable2=rxml variable2,...]""

Comma separated list of variables to send in a POST request.

<insert href='http://www.somesite.com/news/' method='POST' post-variables='action=var.action,data=form.data' />

post-data="string"

String to send as the body content of the POST request. Mutually exclusive with the 'post-variables' argument.

<insert href='http://www.somesite.com/webservice/' method='POST' post-data='&var.data;' />

request-headers=""header=value[,header2=value2,...]""

Comma separated list of extra headers to send in the request.


ignore-unknown-ce="int"

If set, unknown Content-Encoding headers in the response will be ignored. Some servers specify the character set (e.g. 'UTF-8') in the Content-Encoding header in addition to the Content-Type header. (The real purpose of the Content-Encoding header is described here: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11)