stm:insert-after

Home > Books > Tutorials and Training Guides > STM Language > stm:insert-after

Attribute
xpath	required the target path into the operand document

The stm:insert-after operation is used to insert a document fragment after an element located by an xpath. Inserted items are located below the target element. If the xpath value returns multiple targets the fragment is inserted after each of them.

Example

Example 1: Insert a fragment after a target
This example inserts the enclosed /x/y fragment after the first <b> element.
<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:insert-after xpath="/a/b[1]">
            <x>
              <y>zebra</y>
            </x>
          </stm:insert-after>
        </stm:group>
      </operator>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it

Example 2: Insert a param substituted fragment after multiple targets
This is a more complex example. It demonstrates a multivalued xpath target. The xpath /a/b is ambiguous and produces two <b> elements. The insert-after operation is applied to each of the elements. In addition this uses parameter substitution to obtain the /i/j/k fragment which is inserted after <b>.
<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:insert-after xpath="/a/b">
            <stm:param />
          </stm:insert-after>
        </stm:group>
      </operator>
      <param>param.xml</param>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it