<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, POST, PUT or DELETE.

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;' />

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

Comma-separated list of variables to send in a PUT request.

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

put-data="string"

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

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

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

List of extra headers to send in the request. Headers are separated by comma by default, but the delimiter can be changed using the 'header-delimiter' attribute.

header-delimiter="string"

Delimiter to use with 'request-headers', defaults to comma (",").

accept-status="{"value, min_value-max_value[,...]"}"

Comma-separated list of status ranges to regard as successful fetches.

A range is represented by its minumum and maximum values (inclusive) separated by a '-'. A range with a single value can alternatively be represented by just the value by itself.

The default value is "1-399".

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)