1. Exporting the certificate
    
   • If you haven't done so before, accept the certificate when loading a document from your server in your browser.

   In Internet Explorer:

   • Under "Extras/Internet Options/Content/Certificates", select the certificate and click "Export"
   • In the export wizard, choose one of the "X.509" options (the X.509 DER format is recommended) and a file name of your choice.

   In Firefox:

   • The certificates can be found in "Options/Options/Advanced/Encryption".
   • After clicking on "View certificates", select the certificate in the list and click on "Export".
      
2. Creating the Java keystore
    
   • The required command line tool "keytool" can be found in the "bin" folder of your Java installation.
   • The call to this tool should look like this:

     keytool -import -alias pdfcert -file c:pdfcert.cer -noprompt -keystore c:pdfcert.keystore -v -storepass 123456

     Please adjust paths and file names according to your environment:

     "alias" can be chosen freely

     "file" is the certificate from step a.

     "keystore" is the keystore file to be created "storepass" is the password of the keystore file (can be chosen freely, 6 characters minimum)

3. Passing the keystore file as a parameter when starting the Java VM for PDFreactor:

Start the Java VM with the parameter "-Djavax.net.ssl.trustStore=c:pdfcert.keystore" (replace "c:pdfcert.keystore" with the path and name of your keystore file).

After following these steps, converting documents from this server using HTTPS should work correctly. If necessary this steps can be repeated for other servers.

Note: For better readability the license keys of these samples have been arranged over multiple lines. However this not neccessary for the code to function. Under normal circumstances the whole string would be in one line.

Example for Integration in a Java application:

PDFreactor pdfReactor = new PDFreactor();
pdfReactor.setLicenseKey("<license><licensee>"
    + "<name>RealObjects GmbH</name></licensee>"
    + "<product>PDFreactor</product><majorversion>4</majorversion>"
    + "<minorversion>0</minorversion>"
    + "<licensetype>Evaluation</licensetype>"
    + "<expirationdate>2009-12-31</expirationdate>"
    + "<signatureinformation><signdate>2010-03-23 17:58</signdate>"
    + "<signature>302c02141c6f637afc13e0e78134e77d68925a05b789a18202140"
    + "cd3002988cbb155aafb351211840df76dd7781a</signature>"
    + "<checksum>1307</checksum></signatureinformation></license>");
pdfReactor.renderDocument(inputSource, outputStream);

Example for PHP wrapper:

$pdfreactor = new PDFreactor();
$pdfreactor->setLicenseKey("<license><licensee>"
    ."<name>RealObjects GmbH</name></licensee>"
    ."<product>PDFreactor</product><majorversion>4</majorversion>"
    ."<minorversion>0</minorversion>"
    ."<licensetype>Evaluation</licensetype>"
    ."<expirationdate>2009-12-31</expirationdate>"
    ."<signatureinformation><signdate>2010-03-23 17:58</signdate>"
    ."<signature>302c02141c6f637afc13e0e78134e77d68925a05b789a18202140"
    ."cd3002988cbb155aafb351211840df76dd7781a</signature>"
    ."<checksum>1307</checksum></signatureinformation></license>");
$result = $pdfreactor->renderDocumentFromContent($content);

Note: When using the commandline interface for evaluation purposes just copy the licensekey.xml to the same directory as pdfreactor.jar.

To this regard, we recommend taking a look at the "Legacy HTML Code Sample" sample which is part of the PDFreactor sample package. This sample demonstrates how PDFreactor easily converts an HTML 4.0 document into PDF.

InputSource inputSource = ...; //e.g. new InputSource("http://www.realobjects.com/");
OutputStream outputStream = ...; //e.g. new FileOutputStream("realobjects.pdf");
PDFreactor pdfReactor = new PDFreactor();
pdfReactor.renderDocument(inputSource, new PDFreactorConfiguration(), outputStream);

See also the chapter Introducing the Java lib in the PDFreactor Manual.

@page {
    @bottom {
        content: counter(page) " / " counter(pages);
    }
}

For more information, please see the chapter Page Numbers of the PDFreactor Manual.

The content property can contain text, textual content or page numbers. For example, this code will write the content "RealObjects GmbH" in the bottom center margin box of every page:

@page {
    @bottom-center{
        font-family: Times New Roman, serif;
        font-size: 0.5cm; text-align: center;
        content: "RealObjects GmbH";
    }
}

table { page-break-after: avoid }

For more information, please see the chapter Page Breaks in the PDFreactor manual.

div.1 { page-break-after: always; }

For further reference, please see the chapter Page Breaks in the PDFreactor manual.

The GUI Demo tool offers a browser like WYSIWYG view as well as a single and double page PDF preview. You can create each PDF document on-the-fly and save it to your computer. The document's source code and inline style sheets (used in some of the sample documents) can be modified in order to experience the styling-based processing model of CSS. Style sheets and advanced properties of all documents are exposed in separate views as well.

DeD

In the simplest case you only have to specify an input and output file to generate a PDF document. It is also possible to use the operating system's standard input (stdin) and output (stdout) streams to read and write content. This is especially useful when using PDFreactor with server side scripting languages such as PHP, ASP.NET, Perl etc.

Please note, to achieve the same result with the transformation-based processing model of XSL/XSL-FO, you need two different style sheets in two different style languages. CSS for publishing on the Web, XSL/XSL-FO for publishing in print.

For more information about the differences between the styling-based processing model of CSS and the transformation-based processing model of XSL/XSL-FO, please review the section CSS vs XSL.

• Dynamic creation of documents and reports
• Integration into business- and publishing-workflows
• Multi-channel publishing of content through Web and Print
• Invoices, delivery notes and shipping documents on-the-fly
• Automatic generation of technical manuals, data sheets, reports and product information

Since PDFreactor runs on your server, the end-user does not need any software other than a Web browser with a free PDF viewer.

By implementing the W3C specification for Paged Media and print, PDFreactor provides great control over the paged output via CSS. It is very easy to set page sizes, margins and pagination for specific elements, page headers and footers. Using proprietary configuration and CSS properties, it is possible to set PDF specific information, to generate outlines and links for your documents and even to add meta information about the author or keywords.