source

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

Module

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

Syntax

URI

active:source

Argument	Rules	Description
uri	Mandatory	the base URI of the service
arg1	Optional	An argument to append to the service's URI
argN	Optional	An argument to append to the service's URI

Example Usage

DPML

<instr>
  <type>source</type>
  <uri>/myservice</uri>
  <myargument>mydoc.xml</myargument>
  <target>var:result</target>
</instr>

NetKernel Foundation API

The source accessor is provided for use with the DMPL language. It is more efficient to use the following NKF method with scripting languages:

INKFBasicHelper.createSubRequest() issue subrequest

Purpose

The source accessor allows a call to be made to an arbitrary URI specified in the uri argument. Additional arguments are added as named arguments on the active URI sub-request where the argument name is the same as the element name. The assembled active URI request is issued and the result returned.

Example

Suppose we wish to call an interface "ffcpl:/services/wordcount" which returns the word count of a document supplied as a named argument "doc".

<instr>
  <type>source</type>
  <uri>ffcpl:/services/wordcount</uri>
  <doc>mydoc.xml</doc>
  <target>var:result</target>
</instr>

Creates and issues the request...

ffcpl:/services/[email protected]

Multiple arguments are supported so for example...

<instr>
  <type>source</type>
  <uri>ffcpl:/services/vet</uri>
  <dog>hound.xml</dog>
  <horse>equine.xml</horse>
  <target>var:result</target>
</instr>

Creates and requests...

ffcpl:/services/[email protected][email protected]