Description of “webPDF Server”
webPDF is a platform-independent Java- and server-based solution for the conversion of over 100 file formats to the PDF format as well as a solution for digitally signing PDF documents (using an electronic signature). Using a converter enables webPDF to convert various file formats to PDF format without having to install or use the original application. By using digital certificates and digital time stamps, PDF documents can be signed and certified, thus ensuring their originality and correctness.
webPDF has been implemented as a web service based on Apache Tomcat, This allows every user in your organization to access this functionality as Java web services. You can access and use these services in your own applications via the pre-defined (API) interfaces and J2EE architecture. Furthermore, the web service can be installed and used on any J2EE server (e.g. Sun J2EE Application Server, Apache TomCat, etc.).
By using webPDF you need no additional products from third party vendors to convert and/or sign your documents. The PDF conversion and the creation of digital signatures is native functionality and happens without any additional costs "per PDF". webPDF is a ready-to-use and out-of-the-box application (e.g. as a Windows service or a Linux daemon).
Every application in your organization, whether a standard product or a proprietary development, can access the converter (provided it can communicate with web services) and thus make use of the functionality provided.
|
The conversion via these filters is always a conversion of the complete attachment (convert mode) to the PDF and an "amend" to the end of the PDF file (see "general attachment handling" in "Attachments"). The import of the content (import mode) is not possible via this filter. |
|
Please note that an independent license is required to use this interface and for the “webPDF Server" itself. |
The following settings allow you to control the use of the “webPDF Server” (WS) from within n2pdf.All options are set via the function N2PDFSetOption. You can choose from the following function parameters:
N2PDFOPTION_WS_...
The following parameters defines the access to the "webPDF Server". As the converter is a Webservice there are a number of necessary settings for the access to the WebService. If these settings are not set, then n2pdf assumes the "webPDF Server" is installed and running on the same machine ("localhost" or "127.0.0.1") accessible via Port 8080. If this is not the case, then the following information is required.
N2PDFOPTION_WS_ADDRESS |
URL of the machine the Webservice is installed on (without "http://") |
N2PDFOPTION_WS_PORT |
Port for the access to the WebService |
N2PDFOPTION_WS_PROXY |
URL in case the access to the Webservice takes place via a Proxy |
N2PDFOPTION_WS_USER |
User name for access to the Webservice via a Proxy |
N2PDFOPTION_WS_PASSWORD |
Password for access to the Webservice via a Proxy |
N2PDFOPTION_WS_CONVERTER_SELECTION |
"0" = Webservice "OOoConverter" "1" = Webservice "Converter" |
N2PDFOPTION_WS_LOCAL_SERVER |
N2PDFVALUE_TRUE = Converter is available locally N2PDFVALUE_FALSE = Converter is not available locally
In the n2pdf.ini: [SetupWebservice] LocalServer=1 |
N2PDFOPTION_WS_TIMEOUT |
This value (in seconds) defines the maximum waiting period for the execution of a single file conversion (by webPDF). When exceeded, the conversion is aborted (default: 180 seconds).
In the n2pdf.ini: [SetupWebservice] Timeout=180 |
|
The option N2PDFOPTION_WS_CONVERTER_SELECTION is used to select a specific web service and is only used when you are running webPDF version 4.0. |
|
If n2pdf and webPDF are running on the same system, the option N2PDFOPTION_WS_LOCAL_SERVER can be used to improve the performance and the exchange of data between n2pdf and webPDF. A local transfer instead of a transfer via the network allows queries to be executed more quickly, for example, or larger files to be processed. |
Example: Webservice is on IP address "192.168.1.10" and "Port 80"
Call N2PDFSetOption ( JobID, N2PDFOPTION_WS_ADDRESS, "192.168.1.10", "" )
Call N2PDFSetOption ( JobID, N2PDFOPTION_WS_PORT,"80","" )
Additional info can be found on the website: http://www.webPDF.de