stm:create-path

Home > Books > Tutorials and Training Guides > STM Language > stm:create-path

Attribute
xpath	required the target xpath into the operand document
newpath	required the xpath structure of the generated fragment
select	optional an unambiguous xpath into the child document fragment contained by the stm:create-path element

The stm:create-path operation generates a new document fragment and appends it to an element located by an xpath. The generated fragment is built from the unambigious relative xpath structure given by the newpath xpath. Appended items are located below the last child of the target element. If the xpath value returns multiple targets the fragment is appended to all.

Optionally the final leaf element of the created fragment can be set to the value obtained from the select xpath location of an enclosed fragment.

Example

Example 1: Create and Append a new Document Fragment
This example creates a document fragment /d/e and appends it to the <c> element of the first <b> element.
<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:create-path newpath="d/e" xpath="/a/b[1]/c" />
        </stm:group>
      </operator>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it

Example 2: Create a new fragment, Create and set an Attribute

This is a more complex example showing how to generate and set a value on a fragment and also how to create and set an attribute value.

First we create a new fragment b/c with the leaf node <c> given a value pony. The fragment is attached to the root node <a>. Secondly we add a new attribute, food with value grass, to the newly created <c> element.

<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:create-path newpath="b/c" select="." xpath="/a"> pony </stm:create-path>
          <stm:create-path newpath="@food" select="." xpath="/a/b[3]/c"> grass </stm:create-path>
        </stm:group>
      </operator>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it

Example 3: Create a new fragment with param sub value

This is example shows how to generate and set a value on a fragment with the value obtained from a param substitution.

We create a new fragment d appended to the root node /a with a value obtained from the first k element of the param document, by using the select attribute.

<idoc>
  <seq>
    <instr>
      <type>stm</type>
      <operand>doc.xml</operand>
      <operator>
        <stm:group xmlns:stm="http://1060.org/stm">
          <stm:create-path newpath="d/e" select="/i/j[1]/k" xpath="/a">
            <stm:param xpath="/" />
          </stm:create-path>
        </stm:group>
      </operator>
      <param>param.xml</param>
      <target>this:response</target>
    </instr>
  </seq>
</idoc>
Try it