A treat for me today, Brent Lowe from Oracle Partner STR Software sent me a blog entry to share. STR Software provide a really nice, tight delivery server integration for EBS customers. They have developed a user interface to allow you to deliver and monitor documents via the forms interface. If you are not wanting to get into the delivery manager APIs and need a 'delivery' solution that installs in a snap and works with Publisher check out STR's offereing.
Brent's post deals with a delivery channel I did not cover in last year's delivery series - that is the 'custom' channel. He uses the extensibility of the Publisher delivery manager to provide the tight integration that you see in the STR solution today. This was just what we were looking for from a third party when we decided to provide the custom channel option. If you are wondering how you could take advantage of the channel, read on ... if not read on anyway its a good article.
So with out further ado ...
To continue the series on document delivery from EBS, I thought it would be helpful to demonstrate the use of a Custom Delivery Channel. Looking back on Tim痴 original post, the Custom Delivery Channel was defined as:
"Custom" if you have your own channel or a third party delivery solution you (or they) can create a custom delivery channel interface and XMLP will direct documents down that channel.?
As it turns out, we (STR Software) fall into this realm of the 奏hird party delivery solution? and decided to extend the BI/XML Publisher Delivery Manager email and fax capabilities by creating our own Custom Channel. The AventX Custom Channel enables a number of features we felt were necessary to provide in an enterprise environment:
OK, enough about us, let痴 get back to the real point of this post.
Once you have a Custom Delivery Channel, how do you use it?
To demonstrate how to use a Custom Delivery Channel, I thought it would be beneficial to walk through an example of delivering a standard Purchase Order (or any document) from Oracle EBS.
Step 1. Create a class that utilizes the Custom Channel.
There are a couple key points to remember here.
So how do you register your Custom Channel? You have 2 options.
The xdodelivery.cfg file has a section named <channels>, here you can simply define the location of your custom channel痴 Request Factory and it will be made available for the entire Delivery System.
Importing the properties of your custom channel is equally easy; just add an import statement in your source:
Now that you have registered your Custom Channel and imported the properties, using the channel is as easy as setting the appropriate properties to the values that are important to you, your users and the recipients. To see all of the available properties in our custom channel, check out this link. In the example below I am setting the following properties:
// Create an 'aventx' delivery channel
DeliveryManager deliverymanager = new DeliveryManager();
DeliveryRequest deliveryrequest = deliverymanager.createRequest("aventx");
// Add specific properties about this document.
AVENTX_SUBJECT, "Purchase Order #" + sDocId);
"Purchase_Order_#" + sDocId + ".pdf");
// Create the remarks for the coverpage.
sRemarks = "Dear Sir or Madam, \nPlease find the attached Purchase Order #" + sDocId + ".\n" ;
sRemarks += "It has been a pleasure working with you!\n\n";
sRemarks += "Sincerely,\n";
sRemarks += "[SIG=RBL1]\n\n\n\n";
sRemarks += "Brent Lowe";
// Set the actual document to deliver.
// Submit the document.
Step 2. Create a print driver in Oracle to call your class
java AventXDeliverySample $*
if [ $RESULT 墨e 0 ]; then
echo 典here was an error while delivering the document.?
Now when running your Purchase Order Reports, you can simply direct the output to your XMLP Virtual printer!
As you can see, using a Custom Delivery Channel is as easy as using the standard fax and email APIs. What a Custom Channel buys you over the base channels is flexibility. As you値l note from the above example, I have far more control over my document delivery needs as I am able to tailor the channel to my business specifications.