Main

December 14, 2007

LiveCycle - Configuring PDF Generator with an Email Endpoint

1) Get your mail administrator to create an email account for LiveCycle PDF Generator
2) Afterwards, get him/her to send you the following information: a) mailbox userID, b) password, c) mail server host IP address or DNS name, d) POP3 or IMAP port number, e) whether SSL is enabled for POP3/IMAP f) SMTP port number) whether SSL is enabled for SMTP

3) Create a folder on your J2EE appserver machine for failed emails, called 'lc_failed_emails' for example

4) Login to the LiveCycle Admin Console (http://servername:portnumber/adminui/)
5) Navigate to Services > Archive Administration > Service Management
6) Click on 'ConvertAllFileTypesToPDF: 1.0 '
7) In the 'End Points' tab, choose 'Email' from the dropdownlist
8) Click 'Add'

9) For 'Description', type in "Email Endpoint"

POP3/IMAP
10) In 'Inbox Host', type in the IP address or the DNS name of the mail server
11) In 'Inbox Port', type in the POP3 or IMAP service port number
12) In 'Inbox Protocol', choose 'pop3' or 'imap' from the dropdownlist, depending on your case
13) In 'Inbox User', type in the mailbox userID
14) In 'Inbox Password', type in the mailbox user's password
15) Check the checkbox for 'POP3/IMAP SSL Enabled' only if your mail administrator informed you that it is

SMTP
16) In 'SMTP Host', type in the IP address or the DNS name of the mail server. In some cases, the SMTP host will be different from your POP3/IMAP host
17) In 'SMTP Port', type in the SMTP port number
18) In 'SMTP User', type in the mailbox userID
19) In 'SMTP Password', type in the mailbox user's password
20) Check the checkbox for 'SMTP SSL Enabled' only if your mail administrator informed you that it is

21) In 'Failed Email Sent Folder', type in the fully qualified path to the folder you created in step 3
22) In 'Operation Name', choose 'invoke' from the dropdownlist

In the 'Input Parameter Mappings' section:
23) In 'inputDocument', type in *.*

In the 'Output Parameter Mappings' section:
24) In 'Output PDF Document', type in %F.%E.pdf

25) Click the 'Add' button to save the changes.
26) Test by sending a Word document to the e-mail address
27) On the LiveCycle server, watch for a CPU usage spike
28) When the spike is over, check for new e-mail in your mail client. If the conversion succeeded, you should have an e-mail from the mail userID you configured with a PDF attached.

November 23, 2007

The Assembler sample application

Another useful web application, included in the Livecycle SDK, but not automatically deployed is the Assembler sample application.

The Livecycle ES Assembler service can assemble multiple PDF documents into one PDF document or disassemble one PDF document into multiple PDF documents. The Assembler service can manipulate documents in various ways such as changing page size and rotating contents. It can insert additional content such as headers, footers, and a table of contents, as well as preserve, import or export existing content such as annotations, file attachments, and bookmarks.

You use an XML-based language called Document Description XML (DDX), to interact with the Assembler service. Find more info on DDX in the LiveCycle ES SDK documentation.

The Assembler sample application gives you an interface to test your DDX files, which improves productivity.

image

Fill in your DDX, link the input files you use to files on your file system, and the execute button will invoke the Assembler service and show you the generated PDF on the left side.

You can find the Assembler sample application EAR in the SDK folder ...

C:\Adobe\LiveCycle8\LiveCycle_ES_SDK\samples\PDFAssembler\WebApp\pre-built

Deploy the EAR file, and you'll be able to access this information through this url :

http://localhost:8080/adobe/livecycle/samples/assembler/