Home > Contents > 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 supportsARGUMENT
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
Home > Contents > Index > ![]()
Oracle XML Tag Reference
Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.