xpatheval

Home > Books > NetKernel API and Services Reference > Accessor Listing > XML Accessors > xpatheval

Module

The xpatheval accessor is exported by the urn:org:ten60:netkernel:ext:xml:ura module. Import this module to gain access to the accessor.

Syntax

URI

active:xpatheval

Argument	Rules	Description
operand	Mandatory	the resource to be tested
operator	Mandatory	a canonical XPath

Example Usage

DPML

<instr>
  <type>xpatheval</type>
  <operand>foo.xml</operand>
  <operator>bar.xml</operator>
  <target>this:response</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:xpatheval");
req.addArgument("operand", [resource representation, aspect, or URI] );
req.addArgument("operator", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The xpatheval accessor is used to perform a boolean test of an xpath expression on the operand. The operator contains a canonical XPath expression to be evaluated on the operand. xpatheval is often used for controlling process flow.

The truth of an XPath expression can include the document tree matches an xpath location, the value of a location matches a given value or an XPath function matches some value, or a combination of all of these.

xpatheval returns a canonical boolean document: t true, or f false

Example

Test if an Attribute has a given value

<idoc>
  <instr>
    <type>xpatheval</type>
    <operand>
      <a>
        <b name="foo" />
      </a>
    </operand>
    <operator>
      <xpath>//b[@name='foo']</xpath>
    </operator>
    <target>this:response</target>
  </instr>
</idoc>

An example of using xpatheval to test if the operand document has an element with an attribute name with value 'foo'. In this example the xpatheval returns true in the form of a canonical boolean document t