StringToCanonicalString

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

Module

The StringToCanonicalString 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:StringToCanonicalString

Argument	Rules	Description
operand	Mandatory	the URI of the string resource

Example Usage

DPML

<instr>
  <type>StringToCanonicalString</type>
  <operand>this:param:User-Agent</operand>
  <target>var:user-agent</target>
</instr>

NetKernel Foundation API

Scripting languages using NKF should process StringAspects natively.

Purpose

The StringToCanonicalString accessor is used to convert a representation of the type StringAspect into an XML Canonical String Document of the form

<string>some string strange is going on</string>

This is useful in DPML to convert arguments generated by the HTTPBridge accessor to an XML document for easier processing. Within a scripting language the StringAspect representation should be processed using native capabilities.