DirXMLScript DTD: do-append-xml-element element

The <do-append-xml-element> action causes a custom element named by the name attribute to be added to the set of elements selected by expression. If before is not specified the new element is appended after any existing children of the selected elements. If before is specified then it is evaluated relative to each of the elements selected by expression to determine which of the children to insert before. If before evaluates to an empty nodeset or a nodeset that does not contain any children of the selected element, then the new element is appended after any existing children, otherwise the new element will be inserted before each of the nodes in the nodeset selected by before that are children of the selected node.

Example

<do-append-xml-element expression=".." name="jdbc:statement"/>

<do-append-xml-element expression="../jdbc:statement[last()]" name="jdbc:sql"/>

<do-append-xml-text expression="../jdbc:statement[last()]/jdbc:sql">
  <arg-string>
    <token-text> UPDATE dirxml.emp SET fname = '</token-text>
    <token-op-attr name="Given Name"/>
    <token-text>' </token-text>
  </arg-string>
</do-append-xml-text>

2. Attributes

Attribute Value(s) Default Value

before CDATA

XPATH 1.0 expression evalutated relative to each of the nodes select by expression that returns a node-set containing the child node(s) which the new element(s) should be inserted before.
#IMPLIED

disabled true | false

true if this element is disabled
false

expression CDATA

XPATH 1.0 expression that returns a node-set containing the element(s) to which the new element(s) should be added.
#REQUIRED

name CDATA

tag name of the element
supports variable expansion
after expansion, must be a legal XML QName
may contain a namespace prefix if and only if that prefix maps to an available namespace definition
#REQUIRED

notrace true | false

trueif this element should not be traced during execution of policy
false

do-append-xml-element

Example

1. Allowed Content

2. Attributes

3. Content Declaration

4. Parent Elements

Attribute	Value(s)	Default Value
before	CDATA XPATH 1.0 expression evalutated relative to each of the nodes select by expression that returns a node-set containing the child node(s) which the new element(s) should be inserted before.	#IMPLIED
disabled	true \| false true if this element is disabled	false
expression	CDATA XPATH 1.0 expression that returns a node-set containing the element(s) to which the new element(s) should be added.	#REQUIRED
name	CDATA tag name of the element supports variable expansion after expansion, must be a legal XML QName may contain a namespace prefix if and only if that prefix maps to an available namespace definition	#REQUIRED
notrace	true \| false trueif this element should not be traced during execution of policy	false