XFA Specification
Chapter 20, Source Set Specification
Source Set Element Reference
768
The insert element
A SQL command to perform a simple insert operation.
<insert
Properties:
id="xml-id"
name="xml-id"
use="cdata"
usehref="cdata"
>
...pcdata...
</insert>
The insert element is used within the following other elements:
command
The query element can be used to insert record(s) using a cursor and record set. By contrast this element
does not use a cursor or record set. Instead it performs a one-time operation with no persistent context.
Content
The SQL command to send to the database. Operation suspends until the database reports that the
operation is complete.
The id property
A unique identifier that may be used to identify this element as a target.
The name property
An identifier that may be used to identify this element in script expressions.
The use property
Invokes another object in the same document as a prototype for this object. The content of this property is
either a SOM expression (which cannot start with '#') or a '#' character followed by an XML ID.
Starting with XFA 2.4 the object used as a prototype no longer needs to be the child of
proto
. Any object
of the appropriate class can be used as a prototype.
If both
use
and
usehref
are non-empty
usehref
takes precedence.
The usehref property
Invokes an external object as a prototype for this object. The content of this property is an URL, followed
by '#', followed by either an XML ID or by som(SOM_expr) where
SOM_expr
represents a SOM
expression.
The XML ID or SOM expression is resolved in the context of the external document.
If both
use
and
usehref
are non-empty
usehref
takes precedence.