Thank you for your interest in our data extraction add-on - pdf2Data , we hope you will enjoy using our product and share your experiences with us and the iText community. We will walk you through the installation process, from downloading iText 7 pdf2Data to adding the dependency to your .NET building tool.
Finally, if you would require extra help please have a look at our FAQs or the community discussion at Stack Overflow. If you are interested in getting support of our in-house developers and/or a license key for commercial iText products, you will need to acquire a commercial license.
Before you install
- Make sure you have purchased a commercial license of iText 7 Core and pdf2Data - if for commercial purposes. All downloads we offer closed-source come with our commercial license model.
- Download and install the proper license key library, you can find the installation guide here.
- Install iText 7 Core, you can find the installation guide here.
- Important remark: in the installation guide we use NuGet as building tool for .NET.
Installation SDK via NuGet Gallery
iText 7 pdfInvoice is available via Nuget. Simply add iText 7 pdfInvoice by typing the following command in the NuGet Package manager: Install-Package itext7.pdfdata https://www.nuget.org/packages/itext7.pdf2data/
Installation pdf2Data template editor (web application)
Please be aware that for pdf2Data next to the SDK (described above), you also need to install the pdf2Data template editor (web application) - installation instructions can be found here. https://developers.itextpdf.com/webapp-installation-guide-pdf2data-template-editor
Note: The webapp refers to the pdf2Data template editor. Even though you may have purchased the .NET version of pdf2Data, keep in mind that the template editor (which runs in the browser) is deployed as a java web application. The template editor is (strictly speaking) not needed to be able to use pdf2Data, but it does make things a lot easier. For more information on the template editor, check the whitepaper.
- Download a Java SE Runtime Environment and install it. Java 8 or higher is required.
- Download a Apache Tomcat 7.x software and install it (or higher version). Due to the possible issues with compatibility of Java8 and Tomcat7, version 7.0.77 or higher is required for Tomcat7. Any version of Tomcat8 should suffice.
- Download a PDF2Data web application war file. Download the war file from: https://repo.itextsupport.com/webapp/#/artifacts/browse/simple/General/pdf2data/com/duallab/pdf2data/pdf2data-webapp
- Deploy the application on the installed Tomcat server (http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html). In most cases it is sufficient to copy a war file into subdirectory webapps in Tomcat directory ( eg., c:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\)
- Create the file “web.properties”:
- dir.temp=your_folder_for_resources Set temporary directory for resources.
- firstname.lastname@example.org This variable should not be changed.
- mail.smtp.host=smtp.duallab.com Set server name for SMTP protocol.
- mail.smtp.port=25 Set number of port for server.
- mail.ssl.smtp.port=567 Set port of ssl connection for server.
- mail.ssl.enable=false Set true if your server use SSL encryption.
- mail.smtp.starttls.enable=false Set true if your server use STARTTLS encryption.
- mail.from=your email address (e.g. email@example.com)
- user.name=your email address (e.g. firstname.lastname@example.org
- user.password=your email password
- licensekey=path to license file (.xml) (e.g. licensekey=/home/user/license.xml) E.g., settings for GMail server: mail.smtp.host=smtp.gmail.com mail.smtp.port=25 mail.ssl.smtp.port=465 mail.ssl.enable=true mail.smtp.starttls.enable=true Also if your e-mail from gmail account wasn’t sent you would change your account access for less secure apps (https://support.google.com/accounts/answer/6010255?hl=en) These settings are needed to enable the feedback mechanism in the template editor. The feedback will be sent to email@example.com (as indicated in the config file by the mail.to variable), the email will have to be sent from a certain email address (as indicated by the mail.from, user.name and user.password variables).
- Create an environment variable PDF2DATA_PROPERTIES and set it to the path of the file from previous step (f.e. “d:\MyFolder\web.properties”).
- Start Tomcat server (https://docs.oracle.com/cd/E20593_01/doc.560/e23613/app_tomcat.htm) if it was not running before. Example properties file: mail.smtp.host=smtp.gmail.com mail.smtp.port=25 mail.ssl.smtp.port=465 mail.ssl.enable=true mail.smtp.starttls.enable=true mail.smtp.host=smtp.duallab.com mail.smtp.port=25 mail.ssl.smtp.port=567 mail.ssl.enable=false mail.smtp.starttls.enable=false mail.smtp.host=smtp.yandex.ru mail.smtp.port=25 mail.ssl.smtp.port=465 mail.ssl.enable=true mail.smtp.starttls.enable=false licensekey=/home/user/license.xml