Руководство по установке веб-приложения – редактора шаблонов pdf2Data

Примечание: Веб-приложение относится к редактору шаблонов pdf2Data. Несмотря на то что вы могли купить версию pdf2Data для .NET, имейте в виду, что редактор шаблонов (который работает в браузере) развертывается как веб-приложение java. Редактор шаблонов (строго говоря) для использования pdf2Data не нужен, но делает многие вещи намного проще. Подробнее о редакторе шаблонов смотрите в техническом описании.


Руководство по установке

  1. Загрузите и установите Java SE Runtime Environment. Требуется версия Java 8 или выше.
  2. Загрузите и установите программное обеспечение Apache Tomcat 7.x (или более высокой версии).
    Из-за возможных проблем с совместимостью Java8 и Tomcat7 требуется версия Tomcat7 7.0.77 или выше. Любая версия Tomcat8 должна подходить.
  3. Загрузите файл war веб-приложения PDF2Data.
    Загрузите файл war с: https://repo.itextsupport.com/webapp/#/artifacts/browse/simple/General/pdf2data/com/duallab/pdf2data/pdf2data-webapp
  4. Разверните приложение на установленном сервере Tomcat (http://tomcat.apache.org/tomcat-7.0-doc/deployer-howto.html). В большинстве случаев достаточно скопировать файл war в подкаталог webapps в каталоге Tomcat (например, c:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\)
  5. Создайте файл «web.properties»:
    • dir.temp=ваша_папка_для_ресурсов
      Задайте временный каталог для ресурсов.
    • mail.to=pdf2data@duallab.com
      Эту переменную не следует изменять.
    • mail.smtp.host=smtp.duallab.com
      Задайте имя сервера для протокола SMTP.
    • mail.smtp.port=25
      Задайте номер порта для сервера.
    • mail.ssl.smtp.port=567
      Задайте порт соединения ssl для сервера.
    • mail.ssl.enable=false
      Установите значение true, если на вашем сервере используется SSL-шифрование.
    • mail.smtp.starttls.enable=false
      Установите значение true, если на вашем сервере используется STARTTLS-шифрование.
    • mail.from=ваш адрес электронной почты
      например, example@gmail.com
    • user.name=ваш адрес электронной почты
      например, example@gmail.com
    • user.password=ваш пароль электронной почты
    • licensekey=путь к лицензионному файлу (.xml
      (например, licensekey=/home/user/license.xml)

    Например, настройки для сервера GMail:
    mail.smtp.host=smtp.gmail.com
    mail.smtp.port=25
    mail.ssl.smtp.port=465
    mail.ssl.enable=true
    mail.smtp.starttls.enable=true

    Кроме того, если ваше сообщение с учетной записи gmail не было отправлено, вам нужно изменить доступ своей учетной записи для менее безопасных приложений (https://support.google.com/accounts/answer/6010255?hl=en)

    Эти настройки необходимы для включения механизма обратной связи в редакторе шаблонов. Обратная связь будет отправляться ​​на pdf2data@duallab.com (как указано в файле конфигурации согласно переменной mail.to), электронная почта должна быть отправлена с определенного адреса электронной почты (как указано в переменных mail.from, user.name и user.password).
  6. Создайте переменную среды PDF2DATA_PROPERTIES и задайте для нее путь файла из предыдущего шага (например, d:\MyFolder\web.properties).
  7. Запустите сервер Tomcat (https://docs.oracle.com/cd/E20593_01/doc.560/e23613/app_tomcat.htm), если он не был запущен раньше.

    Пример файла свойств:
    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