copy

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

Module

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

Syntax

URI

active:copy

Argument	Rules	Description
operand	Mandatory Fragment OK	the resource to be replicated

Example Usage

DPML

<instr>
  <type>copy</type>
  <operand>foo.xml</operand>
  <target>bar.xml</target>
</instr>

NetKernel Foundation API

The copy instruction is built in to the DPML runtime and so is not available from NKF supported runtimes. However it is easy to use a scripting-language specific assignment of results to a variable.

Purpose

The copy accessor assigns the value of one resource to another. If the resource that is being assigned-to supports SINKing of data then the data will be sunk. This primitive service is built into the DPML language.

Common uses include copying a static or transient resource to a variable. Replicating a resource to the response.

Example

Replicate to a Variable

<idoc>
  <instr>
    <type>copy</type>
    <operand>foo.xml</operand>
    <target>var:vbar</target>
  </instr>
</idoc>

An example of copying a resource into a variable

Replicate a Variable to the Response Document

<idoc>
  <instr>
    <type>copy</type>
    <operand>foo.xml</operand>
    <target>var:vbar</target>
  </instr>
  <instr>
    <type>copy</type>
    <operand>var:vbar</operand>
    <target>this:response</target>
  </instr>
</idoc>

An example of copying a resource into a variable and then copy that variable to the response