MailToPdf Files

1/ Purpose of this project
**************************
The aim of this project is to render allmost all mails (body and attachements) into one or more PDFs.
Focus was not set on a beautiful rendition but on a rendition at all
Mails are read from an imap mailbox or from a file system directory, headless batch converted and then saved as PDF in an output directory

2/ Installation
***************
This project was developped using java. Some dependencies with locally installed products need to be fullfilled

2.0/ Content
			+---mailtopdf
			    +---conf
			    +---files
			    +---files_pdf
			    +---javadoc
			    +---lib
			    +---lu
			    ¦   +---secu
			    ¦       +---mail
			    ¦           +---exception
			    +---src
			        +---lu
			            +---secu
			                +---mail
			                    +---exception

2.1/ Installing the dependencies
	2.1.1/ Install Open Office 
		(v3.2 et v3.3 should work other versions to be tested)
	2.1.2/ Instal the Java(TM) Advanced Imaging
		Visit this link => http://java.sun.com/products/java-media/jai/downloads/download-1_1_2_01.html 
	2.1.3/ (Windows users only) Install file.exe from http://downloads.sourceforge.net/gnuwin32/file-5.03-setup.exe 
				put file.exe in the path or append the PATH variable in mailtopdf.bat script
	2.1.4/ Install the code
		Simply unzip "mailtopdf.zip", no need to build
	
3/ Configuration
****************
		3.1/ Edit the central configuration file (conf/rules.xml) or copy it from rules.unix.xml or rules.windows.xml
	
		<GENERAL_CONFIG> <OPEN_OFFICE_CONFIG> parts have to be modified depending on your installations paths
		
		3.2/ Sample Windows
			<GENERAL_CONFIG>
				<WAIT_TIME>60000</WAIT_TIME>
				<PATH>C:/Temp/mailtopdf/files/</PATH>
				<PDF_TECHNO>JAVA</PDF_TECHNO>
				<DEFAULT_TECHNO>UNRECOGNIZED</DEFAULT_TECHNO>
				<DEFAULT_CMD>UNRECOGNIZED</DEFAULT_CMD>
				<DEFAULT_RENDERED>TRUE</DEFAULT_RENDERED>
				<RENDER_FIRST_HEADERS>TRUE</RENDER_FIRST_HEADERS>
				<FINAL_PATH>C:/Temp/mailtopdf/files_pdf/</FINAL_PATH>
				<EMPTY_IMAGE>C:/Temp/mailtopdf/conf/blank.jpg</EMPTY_IMAGE>
			</GENERAL_CONFIG>
			
			<OPEN_OFFICE_CONFIG>
				<OFFICE_HOME>C:\Program Files\OpenOffice.org 3</OFFICE_HOME>
				<EXECUTION_TIMEOUT>60000</EXECUTION_TIMEOUT>
				<QUEUE_TIMEOUT>600000</QUEUE_TIMEOUT>
				<MAX_TASKS>100</MAX_TASKS>
			</OPEN_OFFICE_CONFIG>
			
			<ADLIB_CONFIG>
				<ADLIB_HOST>not_used</ADLIB_HOST>
				<ADLIB_USER>not_used</ADLIB_USER>
				<ADLIB_PWD>not_used</ADLIB_PWD>
			</ADLIB_CONFIG>

	3.3/ Sample Unix
	
			<GENERAL_CONFIG>
				<WAIT_TIME>60000</WAIT_TIME>
				<PATH>/home/dmadmin/mailtopdf/files/</PATH>
				<PDF_TECHNO>JAVA</PDF_TECHNO>
				<DEFAULT_TECHNO>UNRECOGNIZED</DEFAULT_TECHNO>
				<DEFAULT_CMD>UNRECOGNIZED</DEFAULT_CMD>
				<DEFAULT_RENDERED>TRUE</DEFAULT_RENDERED>
				<RENDER_FIRST_HEADERS>TRUE</RENDER_FIRST_HEADERS>
				<FINAL_PATH>/home/dmadmin/mailtopdf/files_pdf/</FINAL_PATH>
				<EMPTY_IMAGE>/home/dmadmin/mailtopdf/conf/blank.jpg</EMPTY_IMAGE>
			</GENERAL_CONFIG>
			
			<OPEN_OFFICE_CONFIG>
				<OFFICE_HOME>/home/dmadmin/OO/opt/openoffice.org3/</OFFICE_HOME>
				<EXECUTION_TIMEOUT>60000</EXECUTION_TIMEOUT>
				<QUEUE_TIMEOUT>600000</QUEUE_TIMEOUT>
				<MAX_TASKS>100</MAX_TASKS>
			</OPEN_OFFICE_CONFIG>
			
			<ADLIB_CONFIG>
				<ADLIB_HOST>not_used</ADLIB_HOST>
				<ADLIB_USER>not_used</ADLIB_USER>
				<ADLIB_PWD>not_used</ADLIB_PWD>
			</ADLIB_CONFIG>
	
	

4/ Use 
******
	4.1/ change mailtopdf.sh or mailtopdf.bat according to your mailserver host or filesystem properties
	4.2/ launch it
	4.3/ Look at the result in the <GENERAL_CONFIG><FINAL_PATH> location you defined in rules.xml