This sample illustrates the conversion of files from Catia V5, Microsoft Office, Open Office to PDF. The sample also illustrates the conversion of images and PostScript files managed by a Content Management System to PDF files. Using LiveCycle PDF Generator ES2 and LiveCycle PDF Generator 3D to achieve the conversions to PDF. The sample uses a mechanism where only the input files not already in PDF are converted. The sample uses LiveCycle Content Services for managing the contents.
This sample consists of two components in which one is a LiveCycle process and other one is a DSC (Document Service Component). The purpose of both become clear in description given later. The sample uses Content Services to trigger the invocation of the sample process when a document is added or updated in the Content Services. The sample then takes converts the updated file to PDF and stores at a location as specified in the property of sample process.
Following are methods to handle the input file added or updated in Content Services based on the file type. (A file type is decided based on the extension of the filename):
Input file is a 2D file. The sample uses Generate PDF Service to convert the input file to PDF and store it at the location as specified in sample process property.
Zip file containing 2D files. The sample extracts the input files contained inside the zip file to a parallel folder. The sample uses the Generate PDF services to convert the input files. The sample creates a PDF Portfolio containing all the generated PDF files. Extracting the files inside zip is for optimization purposes. The next time the same zip file is uploaded only the new or updated files are extracted. The extract is done after comparing the changed files with the files existing in Content Services.
Files needed for the sample
Input:
Input 3D files, file formats supported by CreatePDF2 API of PDF Generator Service (for example: images, MS Office documents, OpenOffice documents, Plain text documents and others.) and Zip file containing file formats supported by PDF Generator Service.
Other parameters required by Adobe-Samples-3DPDFG-CS.lca are configured using LiveCycle Workbench. Parameters include:
inDoc: Document converted to PDF.
assemblyPartsFilters: pattern to recognize parts of assembly for 3D conversions.
assemblyFileFilter: pattern to recognize main Assembly for 3D conversions.
forcePartConversion: Boolean flag identifying whether to force the conversion of assembly parts.
forceAssemblyConversion: Boolean flag identifying whether to force the conversion of assembly.
skipExplorationOp: Boolean flag identifying whether to skip the exploration of file.
Output:
The outputs of sample vary depending on the input submitted to it. Followings are the output based on the input files:
3D Files:
Output is 3D PDF. The output is an assembled PDF when the folder contains the base file for the assembly and the supported part files.
Files supported by PDF Generator service:
Output is a PDF file.
Zip file containing files supported by PDF Generator service:
In this case output is a PDF Portfolio containing all the PDF files converted from input files in the input Zip file. If, any of the file inside the zip is corrupt or invalid then skip that file and consider other valid files.
Deploying the sample
Pre-requisites
Ensure that the following components are deployed on LiveCycle Server:
Adobe LiveCycle PDF Generator ES2
Adobe LiveCycle PDF Generator 3D ES2
Adobe LiveCycle Content Services ES2
Also ensure following depending on the Operating System on which LiveCycle server is running:
Windows 2003: Start the LiveCycle ES2 service with one of the users who has access to the Content Services review store location. Alternatively, start the server from the command prompt.
Windows 2008: Start the LiveCycle ES2 server from the command prompt.
Deploying Sample DSC
Deploy the sample DSC using the LiveCycle Workbench.
Go to “Components” view tab.
Right click Components and click Install Component.
Browse and select the DSC (adobe-pdfg3dsample-dsc.jar).
Right click the DSC imported and select “Start Component”
Deploying and Configuring sample process
Deploy the sample process using Workbench:
Navigate to Home > Services > Application and Services > Application Management in Adobe LiveCycle Administration Console.
On the LiveCycle Applications tab click Import.
Browse and select Adobe-Samples-3DPDFG-CS.lca.
Select the check box for PDFG 3D CS Sample and click Deploy link to deploy the sample application.
Configuring the sample
Configuring the sample consists of two parts:
Configuration of CIFS.
Configuration of Sample Application:
Open the Adobe LiveCycle Workbench and connect to the server on which the sample application was deployed.
Select File > Get Application and select the PDFG 3D CS Sample.
Right click Generate 3D PDF Sample under PDFG 3D CS Sample and select checkout option to configure the process.
Double click Generate 3D PDF Sample to open the sample process in LiveCycle Process Design perspective.
Double click createPDF (the operation exposed from the sample DSC). Configure the properties on the “Properties” tab. Provide the valid values to all the mandatory input fields.
Right click Generate 3D PDF Sample and select the check in option to commit the changes on the server.
Testing the sample
Test Case 1
Input a 3D input file in the input directory configured in the sample process above.
Output a 3D PDF file to the configured output directory.
Test Case 2
Input a set of files containing the base 3D file and the 3D part files. The input directory configured in the sample process above.
Output is a complete assembly PDF which can be found under the configured output directory.
Test Case 3
Input an MS Office Document in the input directory configured in the sample process above.
Output is a PDF which can be found under the configured output directory.
Test Case 4
Input a Zip file containing various 2D files.
Output is a PDF Portfolio file containing the PDF file corresponding to the files in the input Zip file. The output is generated in the configured output directory.
Legal disclaimer
Any references to company names, company logos and user names in sample material or sample forms included in this documentation and/or software are for demonstration purposes only and are not intended to refer to any actual organization or persons.
SDK Sample - LiveCycle ES2 PDF Generator 3D - Create 3D PDF File -
10/01/2010 2:03 PM
LiveCycle ES2 (9.0.0.2) - September 2010
[an error occurred while processing this directive]