Intray Transport

This document provides a guide to the tpt_intray module which hosts the Intray transport.

Overview

The Intray transport is an in-tray to out-tray processor. It allows files to be dropped into an "in" directory, processed with a configurable process and the result is written to an "out" directory. This is a classic pattern, it is provided as an example of an alternative to the HTTP transport and can be a useful transport for resource processing on a network fileshare - for example to distill XSL-FO sources to PDF etc.

Configuration

To use this transport import urn:org:ten60:netkernel:tpt:intray into the fulcrum module.xml which will host this transport. Register the transport by adding the IntrayTransport class to the transports section for your module eg

The Intray transport reads it's configuration from ffcpl:/etc/TransportIntrayConfig.xml in the module filesystem. In your fulcrum create an etc/ directory and copy the config file example shown below to TransportIntrayConfig.xml. Make sure that the ffcpl:/etc directory is mapped in the internal address space of the fulcrum module by adding the following to the mapping section of the module.xml

The Intray configuration file is as follows

• in/out - are the file names of the in and out directories. Make sure the user under which NetKernel is running has read/write privileges to these directories
• processURI - is the URI the kernel will execute for each file received in the intray. This example executes a DPML process. Note the Intray transport passes the file URI to the process on the param argument.
• pollInterval - is the frequency in milliseconds that the Intray transport will poll the Intray for new files to process.