Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

INSERT

Inserts the content of a file or URL into the current output stream or sets the content into a variable.

Syntax

<INSERT [FILE="FILE_NAME"]
        [URL="URL"]
        [NAME="VAR_NAME"]/>

Parameters

FILE (optional)

Name of file to insert into the current output.

URL (optional)

URL to insert into the current output.

NAME (optional)

Name of the variable to set with the content of FILE or URL.

Description

The INSERT tag inserts the content of a file or URL into the current output stream or sets the content into a variable. In addition, it supports ARGUMENT constructs for compound URL INSERT tags. For example, when an INSERT tag specifies URL (as opposed to FILE), the arguments supplied are attached to the URL line as follows:

• A question mark (?) is appended to the URL value.

• The argument name/value is appended as name=value for each argument supplied

• All white space in the URL is replaced with %20 to make it appropriate for HTTP transport to a browser.

Error Numbers

The possible values of errno include:

Value	Description
-300	File not found.
-303	Path not found.

Example

This example inserts a file whose path is constructed by concatenating a property from the Sites properties file and the value of the variable "prolog". The content of the file is inserted into the output.

<SETVAR NAME="prolog"
        Value="CS.Property.PrologDir"/>
<INSERT FILE="Variables.prolog/Sites"/>

This example sets the content of a relative URL to a variable, formbits, then displays the value of the variable.

<INSERT URL="/futuretense_cs/formbase.html"
        NAME="formbits"/>
<CSVAR NAME="Variables.formbits"/>

See Also

CSVAR

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.