formURIEncode

Home > Books > NetKernel API and Services Reference > Accessor Listing > Utility and System Accessors > formURIEncode

Module

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

Syntax

URI

active:formURIEncode

Argument	Rules	Description
operand	Mandatory	the resource to encode

Example Usage

DPML

<instr>
  <type>formURIEncode</type>
  <operand>var:nvp</operand>
  <target>var:string</target>
</instr>

NetKernel Foundation API

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

Purpose

The formURIEncode accessor converts a parameter as an XML fragment in the form of a name value pair list into the MIME media type application/x-www-form-urlencoded encoding. This is useful when working with web form submissions and displays.

The encoded parameter is provided as the operand and the result is delivered to the target argument.

We need a discussion of, or reference to, the name-value pair XML fragment format. It would also be nice to have a reference to the encoded form or an example.