cwu

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

Module

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

Syntax

URI

active:cwu

Argument	Rules	Description
operand	Optional	the URI to use as the current working URI

Example Usage

DPML

<instr>
  <type>cwu</type>
  <operand>ffcpl:/my/working/path/</operand>
</instr>

NetKernel Foundation API

The cwu instruction is built-in to the DPML runtime and so is not available from NKF supported runtimes. In a scripting-language the current working URI of sub-requests may be changed using NKF:

INKFRequest.setCWU() Sets the CWU for a single sub request.

INKFBasicHelper.setCWU() Sets the CWU for all subsequent sub requests - this may be set on the context object.

Purpose

The cwu accessor is used to set the current working URI within a DPML execution - normally the URI of the DPML script is taken as the current working URI. All relative URIs are resolved against the current working URI. This primitive operation is built into the DPML language.

cwu can be called with a canonical URI document using the curi: scheme for dynamic assignment of the CWU.

If the operand is omitted then the CWU is set to null and no relative URIs can be resolved. This can be useful when calling scripts that will determine their own CWU if one is not specified.