PASTA Printing with the 1-1 Fulfillment Server

Oracle CRM Support

11.5.10 Oracle Applications

PASTA Printing with the 1-1 Fulfillment Server

A R

T F

Author: Amanda Spruyt CRM Support

Pasta_Printing.doc

1/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

Contents
Contents ............................................................................................................... 2 1. Testing a Operating System Print ........................................................................ 4 2. Install XPDF ........................................................................................................ 5 3. Using XPDF......................................................................................................... 6 4. Printing PostScript files with PASTA ................................................................. 6 5. Test a PASTA Print ............................................................................................. 8 6. Using One-to-One Fulfillment Administrator to create a Pasta Printer............... 8 7. Link the Pasta Printer to a 1-1 Fulfillment Server. .............................................. 9 8. Upload PDF File with Oracle Content Manager ............................................... 10 9. Start the 1-1 Fulfillment Server ......................................................................... 12 10. Issue Print Request from Oracle Applications............................................... 13 11. Viewing Log files .......................................................................................... 15 11.1. Errors[n].log........................................................................................... 15 11.2. jtfmctl.txt................................................................................................ 15 11.3. Events[n].log.......................................................................................... 15

A R

T F

Pasta_Printing.doc

2/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

1. Introduction
This document describes the configuration and set-up for the Oracle 1-1 Fulfillment Server for use with PASTA printing. The instance used was VISSC01 11.5.10 on a Linix Server. Where possible screen shots of configuration are used. The set-up was completed by following: Oracle One-to-One Fulfillment Implementation Guide. B10634-02

Please read this document in conjunction with this paper. The final test used the Oracle Marketing Online application to make the print request.

A R

T F

Pasta_Printing.doc

3/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

2. Testing a Operating System Print

First the 1-1 Fulfillment Server Machine will need to have a print queue defined for use by the 1-1 Fulfillment Server.

Please Note, If no print queue is defined on the Server this will have to be configured by the Customers Server Administrator.

In our case this is: t551jp - Portrait queue on the Printer in TVP 550.

Second we need to be sure the 1-1 Fulfillment Server machine is able to print a simple text file. Make a telnet session onto the 1-1 Fulfillment Server Machine. Then issue the following command: lp -dt551jp ajs.sh

The text file should be printer out on the expected printer before continuing with the installation.

Please Note, if using a Windows Machine as the 1-1 Fulfillment Server the command will be print rather than lp.

A R

T F

Pasta_Printing.doc

4/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

3. Install XPDF
In order for PASTA to print PDF Files requires a pre-conversion from PDF to PostScript. This can be achieved by installing the XPDF product from the following URL, as detailed in the 1-1 Fulfillment Server Implementation Guide detailed above in the Introduction:

http://www.foolabs.com/xpdf/download.html

In our case the 1-1 Fulfillment Server machine is a Linix box so we require: x86, Linux (glibc 2.2, staticly linked to Motif, t1lib, and FreeType): xpdf3.01-linux.tar.gz (5599825 bytes)

Download the version and then upload on the 1-1 Fulfillment Server Machine. In our case we downloaded xpdf-3.01-linux.tar.gz and uploaded the file onto vissc01. Lastly unpack the tar file on the 1-1 Fulfillment Server with the following command: tar -xf xpdf-3.01-linux.tar

This will create a directory with content like the following:

cd xpdf-3.01-linux ls ANNOUNCE INSTALL pdfimages pdfinfo.1 pdftops pdftotext.1 xpdf CHANGES pdffonts pdfimages.1 pdftoppm pdftops.1 README xpdf.1 COPYING pdffonts.1 pdfinfo pdftoppm.1 pdftotext sample-xpdfrc xpdfrc.5

A R

T F

Please Note, depending on the Operating system used the compressed file format may differ. With Windows this will be a ZIP file. Also Note, that if pre-compiled libraries of XPDF do not exist for your operating system, the source files are included on the website, so that you may build your own.

Pasta_Printing.doc

5/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

4. Using XPDF
We can test that the XPDF utility can convert a PDF File to PostScript by using pdftops. Upload a PDF file onto the 1-1 Fulfillment Server Machine, and then test with: pdftops ReadMe.pdf

This will create a ReadMe.ps PostScript File.

5. Printing PostScript files with PASTA

Using the PostScript file created by pdftops we can use the PASTA print command to print the PostScript File:

FNDPSTAX -fReadMe.ps -pnt551jp

The f is the parameter for the Postscript File, and the pn is the parameter for the Printer. The PDF should be printed out on the Printer in the correct format.

A R

T F

Pasta_Printing.doc

6/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

6. Configuring pasta.cfg
The Pasta configuration file is found in the following directory: /global/oracle/vissc01/vissc01appl/fnd/11.5.0/resource

The file is called: pasta.cfg

There are two options here either the pasta.cfg file may be amended or the file may be copied to pasta_<printer_name>.cfg. If the file is copied the copy for the printer is used, if not the default pasta.cfg is used. Copied this file to pasta_t551jp.cfg

We need to amend the pre-process options for PDF:

Find %Preprocess for PDF output in the file pasta_t551jp.cfg Uncomment and amend:

preprocess=/global/oracle/vissc01/vissc01comn/admin/scripts/Interacti on_Center/ajs/PASTA/xpdf-3.01-linux/pdftops {infile} {output}

A R

T F

Pasta_Printing.doc

7/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

6. Test a PASTA Print

Now we can try a PASTA print with the PDF file rather than the PostScript file tested in Chapter 5 above. FNDPSTAX -fReadMe.pdf -pnt551jp

This should now print a pdf file to the printer. ( The conversion to Postscript being handled by the pre-processing option set in the pasta_ t551jp.cfg).

7. Using One-to-One Fulfillment Administrator to create a Pasta Printer.

Responsibility: Navigation: One-to-One Fulfillment Administrator Printer/Create

Use the above screen to create a PASTA Printer as follows:

D
t551jp

A R

T F

Make sure the printer name is the same as used by the lp command and the FNDPSTAX commands used earlier:

Pasta_Printing.doc

8/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

8. Link the Pasta Printer to a 1-1 Fulfillment Server.

Responsibility: Navigation: One-to-One Fulfillment Administrator Server

Select the 1-1 Fulfillment Server to add the PASTA Printer to. Then configure the Print Servers Tab as follows.

Server 10001 is now linked to Pasta Printer t551jp.

A R

T F

Pasta_Printing.doc

9/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

9. Upload PDF File with Oracle Content Manager

Responsibility: Navigation: Create a Content Type for Print Only: One-to-One Fulfillment Administrator Content

Create a Cover Letter based on the Content Type:

A R

T F

Pasta_Printing.doc

10/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server Make sure the Cover Letter has an Approved Live version for use in the calling Application:

A R

T F

Pasta_Printing.doc

11/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

10. Start the 1-1 Fulfillment Server

Start the required 1-1 fulfillment Server with a command like: jtffmctl.sh

Check the jtffmctl.txt file to make sure the PASTA Printer configuration has been picked up, the file will contain lines like the following: GETTING PRINTER CONFIGURATIONS ... PRINT SERVER: 'Address:t551jp; Type:PASTA'

A R

T F

Pasta_Printing.doc

12/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

11. Issue Print Request from Oracle Applications

In our test case this is Oracle Marketing Online for 11.5.10. We create a Campaign Schedule of type Direct Marketing/Direct Mail:

This allows us to set the Printer name and the Cover Letter. When the Campaign Schedule becomes Active the 1-1 Fulfillment Request is made:

A R

T F

Pasta_Printing.doc

13/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

If the request is successful the document will be printed on the Printer:

A R

T F

Pasta_Printing.doc

14/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

12. Viewing Log files

There are three log files created for the request Events.log, Errors.log and jtffmctl.txt. 12.1. Errors[n].log This file should be empty. 12.2. jtfmctl.txt This should contain details of a successful request: (MDS SERVER) > NEW MASS REQUEST [1] (MDS SERVER) > enqueued segment '1' of size '1611' bytes into queue 'JTO_10001_B_Q' for batch processing (MDS SERVER) > NEW BATCH REQUEST [1] (MDS SERVER) > MASS REQUEST PROCESSED (13006)[1] tec:0 load:1 (MDS SERVER) > NEW MASS RESPONSE [1] (MDS SERVER) > BATCH REQUEST PROCESSED (13006)[1] tec:0 load:0 (MDS SERVER) > MASS REQUEST '13006' WAS SUCCESSFUL (MDS SERVER) > MASS RESPONSE PROCESSED (13006)[1] tec:0 load:0 12.3. Events[n].log -- Request is received by the 1-1 Fulfillment Server:

Time : --Wed Sep 14 02:37:54 PDT 2005--56 seconds, 746 milliseconds-Message : (r0.0:p0) dequeued from queue 'JTO_10001_M_Q' > <?xml version = '1.0' encoding = 'UTF-8'?><ffm_request id="13006" submit_time="2005-09-14 02:37:50" status="NEW" template="10927" priority="1" user_history="YES" api_version="1" user_id="1007881" source_code_id="20934" source_code="AMER080500012" object_type="AMS_CSCH" object_id="18740" doc_id="1" doc_ref="UNSET" app_id="690" login_id="-1" resp_id="21706" org_id="204" bypass="none" email_body="none" pasta_printable="yes">

A R

T F

-- Note Pasta Printable Should be yes. -- Then we see the PDF file downloaded. Time : --Wed Sep 14 02:38:45 PDT 2005--1 minute, 48 seconds, 132 milliseconds-Message : (r13006.0:p0) downloaded rendition for fnd_lobs file_id = '328981' RfcContentRendition[name:ReadMe.pdf,mime:application/pdf,lang:US,charset:UTF8 ,data:26283 bytes]

Pasta_Printing.doc

15/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server

-- Next we create a tempory PDF File. -- <98.0> -Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 3 seconds, 603 milliseconds-Message : (r13006.1:p53287) created temp file /global/oracle/vissc01/vissc01comn/admin/scripts/Interaction_Center/ajs/Fulfillment/ Logs/tmp/6.940269867074276E8-ReadMe.pdf -- Next we run XFDF ? -- <99.0> -Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 3 seconds, 689 milliseconds-Message : (r13006.1:p53287) PDF Merge XFDF : <?xml version = '1.0' encoding = 'UTF-8'?> <xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve"> <fields/> </xfdf> -- Next we create a second temp file. -- <100.0> -Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 3 seconds, 751 milliseconds-Message : (r13006.1:p53287) created temp file /global/oracle/vissc01/vissc01comn/admin/scripts/Interaction_Center/ajs/Fulfillment/ Logs/tmp/4.091616143324898E8-ReadMe.pdf -- Next we prepare to print.

-- <101.0> -Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 3 seconds, 752 milliseconds-Message : (r13006.0:p53287) printing files : '/global/oracle/vissc01/vissc01comn/admin/scripts/Interaction_Center/ajs/Fulfillment/ Logs/tmp/4.091616143324898E8-ReadMe.pdf' to printer 't551jp' for '' -- Next we send the FNDPSTAX command. -- <102.0> -Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 3 seconds, 752 milliseconds-Message : (r0.0:p0) printing pdf with command : FNDPSTAX -pnt551jp -t"" f/global/oracle/vissc01/vissc01comn/admin/scripts/Interaction_Center/ajs/Fulfillment/ Logs/tmp/4.091616143324898E8-ReadMe.pdf -- Next we get the response back from PASTA and the request was a success. -- <103.0> --Time : --Wed Sep 14 02:39:01 PDT 2005--2 minutes, 4 seconds, 45 milliseconds-Message : (r0.0:p0) PASTA STDOUT: request id is vissc01@celalnx18+507 Time : --Wed Sep 14 02:39:21 PDT 2005--2 minutes, 24 seconds, 80 milliseconds--

A R

T F

Pasta_Printing.doc

16/17

9/22/2005

PASTA Printing with the 1-1 Fulfillment Server Message : (r0.0:p0) MASS REQUEST '13006' WAS SUCCESSFUL

A R

T F

Pasta_Printing.doc

17/17

9/22/2005