dpml

Home > Books > NetKernel API and Services Reference > Accessor Listing > DPML > dpml

Module

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

Syntax

URI

active:dpml

Argument	Rules	Description
operand	Mandatory	the DPML script to execute
operator	Optional	a resource to specify the execution context
param	Optional	resource to pass as a parameter to the script

Example Usage

DPML

<instr>
  <type>dpml</type>
  <operand>foo.idoc</operand>
  <target>var:barvar</target>
</instr>

NetKernel Foundation API

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

Purpose

The dpml accessor is used to execute a DPML script. Please note, for legacy reasons DPML differs from the other language runtimes in that the script is specified as the operand argument and *not* the operator. Also, DPML declares all results as 'cacheable' - see declareIntermediate.

See the DPML tutorial for an in depth guide to executing a DPML sub-process from within a DPML process.

Operator Syntax

The DPML accessor takes an optional <operator> which may qualify the context for executing the script.

<dpml>
  <inheritCWU>t/f</inheritCWU>
</dpml>

inheritCWU inherit the current context's Current Working URI in the DPML sub-process. If false, it uses the sub-process's script URI as the current working URI. Default is false.