Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
панель
titleНавигация

На этой странице:

Оглавление

Свойства страницы
Статус

Статус
colourBlueGreen
titleТребуется ДоработкиГОТОВО

КомментарийНаписать инструкцию по настройке среды разработки для CMJ и Отчетов

Палитра XML

  1. Установить Intellij IDEA Community Edition 2019.2.4 или выше
  2. Установить XMLConfigPlugin (http://nexus.inttrust.ru:8081/nexus/content/repositories/releases/ru/intertrust/cmj/cmpalette-plugin/)
  3. Скачать репозиторий палитры. Запросить ссылку на репозиторий у руководителя проекта.
  4. Скачать xsd файлы и поместить их в корень проекта. Запросить файлы у руководителя проекта.
  5. Собрать палитру
  6. Загрузить на стенд CompanyMedia

CMJ

Информация
iconfalse

Инструкция работает с версией CMJ Server 7.0.0.464.

Все необходимые файлы есть в хранилище http://192.168.1.13:8888/cgi-bin/ в папке /Dev/CompanyMedia/CM7.0.0.Instruction. Необходимо иметь доступ к хранилищу.

Для настройки Git и скачивания репозитория проект необходим персональный файл .ppk.

  • Установить JDK 1.8. Не забыть установить переменные среды.
  • Скачать средство сборки проектов Apache Maven (из хранилища) и расположить в папке C:\Program Files\Maven\ . ВАЖНО! При расположении в другой папке нужно в файле ...\apache-maven-3.8.4\conf\settings.xml зменить путь параметра localRepository.
    Установить переменные среды окружения M2, M2_HOME, MAVEN_HOME, добавить MAVEN_HOME в список путей в переменной Path.
  • В корень диска C: кладутся :
    - папка cm-config. На неё будут ссылаться переменные в standalone.xml сервера приложений Wildfly.
    - папка cm5. Она содержит пустые папки, которые будут использоваться для хранения файлов в системе.
  • Установить PostgreSQL версии 13 (https://www.postgresql.org/download/windows/, в хранилище есть нужная версия 13.2.2, которая точно работает) вместе с встроенным приложением pgAdmin. Создать пользователя с именем "admin" и паролем "admin", выдать ему максимальные права.
    Создать 2 базы данных:  cm7_af5, cm7_cmj, владельцем должен быть admin. Запустить pgAdmin, восстановить базы данных из бэкапов(есть в хранилище). Image RemovedImage RemovedСкачать из хранилища сервер приложений wilfly 21.0.0.Final.
    В файле wildfly-21.0.0.Final\bin\standalone.conf.bat проверить и изменить при необходиомсти путь в переменной "JAVA_HOME=C:\Program Files\Java\jdk1.8.0_171"
    В файле wildfly-21.0.0.Final\standalone\configuration\standalone.xml проверить и изменить при необходиомсти: 
    - путь в переменной "REPOSITORY_INIT_FOLDER" - она должна ссылаться на папку репозитория "...\sochi\ssrv-sochi-fellow\src\main\resources\importdata\testing".
    - адреса баз данных, порты в них и пароли к ним - они должны соответсвовать созданным ранее базам данных.Image Removed
  • Установить Intellij IDEA Ultimate Edition (является платной версией) или Spring Tool Suite (https://spring.io/tools). Установку и запуск среды раработки производить от имени администратора.
  • Скачать репозиторий проекта. Для этого установить GitExtentions версии 2.50.02 и произвести настройку согласно инструкции https://conf.inttrust.ru:8443/pages/viewpage.action?pageId=4489405 (vtbsdo20-4489405-160718-1115-112.pdf)

    Информация

    Могут быть проблемы с загрузкой репозитория из-за версии putty agent. Версия 0.70 не работает (шлет какой-то запрос, который не распознает удаленный сервер, в итоге соединение отваливается). Точно работает 0.67 и 0.64 plink.exeputtygen.exepageant.exe

    Открыть проект с помощью среды разработки. 

    В среде разработки:
    - настроить путь к JDK
    - установить VM Options: -Dmaven.test.skip -DskipTests -Dmaven.javadoc.skip=true -Denforcer.skip=true -Xmx8192m
    - настроить автоматическое форматирование кода:  файл для Intellij IDEA прилагается файл InterTrustFormatter_idea.xml.
    - настроить Maven как срество сборки проекта. Указать устанорленный экземпляр. 
        User settings file = C:\Program Files\Maven\apache-maven-3.5.2\conf\settings.xml
        Local repository = C:\Program Files\Maven\repository

    Image Removed

    Image Removed

    Image Removed

    Image Removed

    Собрать проект с помощью Maven. вызовом "mvn clean install"  в модуле srv-parent(CMJ server).Image Removedнастроить подключение к серверу приложений в среде разработки. В списке артефактов для деплоя как минимум должeн быть "ssrv-overall-ear-<номер версии>.ear".Image RemovedImage RemovedЗапустить приложение. При этом в браузере должна открыться страница Рабочего места администратора по пути http://localhost:8095/ssrv-war/  Image Removed

    JasperReports

    панель
    titleУстановить плагин в IDEA

    View file
    nameinstall plugin.mp4
    height150

    панель
    titleИмпорт конфигурации

    View file
    nameimport.mp4
    height150

    панель
    titleСборка

    View file
    namebuild.mp4
    height150

    панель
    titleЭкспорт конфигурации
    View filenameexport.mp4height150


    Настройка СЭД Сервиса

    Установить MS Office

    1. Установить MS Office (достаточно произвести установку Word и Excel), проверить что он установлен. Перезагрузить Windows если установка проводилась.

    2. Проверить наличие и права на папки (создать если нет): C:\Windows\SysWOW64\config\systemprofile\Desktop C:\Windows\System32\config\systemprofile\Desktop

    Установить и настроить WildFly 16

    Подсказка
    iconfalse

    Если CMJ-сервер запущен на WildFly 16, то можно пропустить этот шаг

    1. Поставить WildFly 16, тип запуска Automatic, запуск службы желательно производить от «Local System Account» (С системной учетной записью) и активным чек-боксом «Allow service to interact with desktop» (Разрешить взаимодействие с рабочим столом).
      При желании можно запускать WildFly под администратором или технологической учетной записью, имеющей права администратора на сервере, хоть это и не рекомендуется.

    2. В каталог с настройками CM, который указан в файле конфигурации WildFly - /standalone/configuration/standalone.xml:

      Блок кода
      title/standalone/configuration/standalone.xml
      <system-properties>
          <property name="server.properties.location" value="<path>"/>
          ...
      </system-properties>

    Конфигурация СЭД Сервис

    Поместить файл sedsvc.properties по пути server.properties.location

    Проверить настройки DCOM

    Запустить через Win+R dcomcnfg, в нем открываем Console Root-Component Services-Computers-My Computer-DCOM Config (Корень консоли-Службы компонентов-Компьютеры-Мой Компьютер-Настройка DCOM)
    Для объектов:

    Без форматирования
    Документ Microsoft Word 97–2003
    Office Licensing COM Server 16
    Microsoft Excel Application

    В свойства выставить:

    Identity (Безопасность) - the launching user (Запускающий пользователь)

    Если WildFly запускается под администратором или некой технологической учетной записью (п.3) для тех же объектов DCOM требуется на вкладке "Безопасность" в каждом из разделов ("разрешение на запуск и активацию", "разрешение на доступ", "разрешение на изменение настроек") прописать эту учетную запись персонально, указав права идентичные группе Администраторы. На вкладке "Удостоверение" указываем запуск от указанного пользователя. Если запуск WildFly настроен под системной учетной записью дополнительных настроек на вкладках "Безопасность" и "Удостоверение" не требуется.

    Первый запуск

    Выполняем первый запуск офиса под учетной записью из-под которой запускается WildFly. Для запуска из-под системной учетной записи используем утилиту psexec входящую в пакет MS SysInternals УТИЛИТА

    Блок кода
    languageactionscript3
    titleЗапуск Word 2016 через CMD
    psexec.exe -sid "C:\Program Files\Microsoft Office\Office16\WINWORD.exe"
    Блок кода
    languageactionscript3
    titleЗапуск Excel 2016 через CMD
    psexec.exe -sid "C:\Program Files\Microsoft Office\Office16\EXCEL.exe"

    В всплывающем окне при первом запуске поставить чек-бокс "Использовать приложение по умолчанию". Также, необходимо установить Ассоциирование расширений файлов doc, docx для MS Word; xls, xlsx для MS Excel. При последующих запусках никаких всплывающих окон возникать не должно (блокирует).
    После чего необходимо снять чек-бокс в параметрах Word "Общие -> Параметры запуска -> Открывать вложения электронной почты и другие нередактируемые файлы в режиме чтения". Помимо этого, можно выполнить ряд рекомендательных настроек для увеличения быстродействия работы сервиса:

    1. Настройки MS Word
      Image AddedImage Added
      P.S. Папка D:\MSOfficeTemp должна быть создана предварительно для временных файлов, можно использовать любую другую временную папку.
      Image Added
    2. Настройки MS Excel
      Image AddedImage Added
      Image AddedImage Added
    3. Общие настройки безопасности для Word и Excel
      Image AddedImage AddedImage AddedImage AddedImage AddedImage Added
    4. Уникальные параметры безопасности Excel
      Image Added
    1. Добавить в папку деплоя WF приложение SEDSVC-3.Х.Х.war последней версии (\\192.168.1.13\Dev\CompanyMedia\CM7.0.0.Instruction)

    2. Запусть WildFly .

    3. Убедиться что запустился WildFly , SEDSVC-3.Х.Х.war задеплоился и создались процессы офиса в количестве указанном конфиге sedsvc.properties (п.5 данной инструкции).

    Проверить корректность работы

    1. Проверить корректность работы svcWord2Pdf из страницы SEDSVC:

      • Зайти на страницу сед-сервиса http://<hostname>:<port>/sedsvc-war/ 

      • Перейти на страницу проверки “exec Word2Pdf converter”

      • В окне mainData ввести json:

        Блок кода
        languagexml
        {
                    "doPdfValidate" : true,
                    "priority" : "NORMAL",
                    "isMakeStamp":true,
                    "files": [{
                                "document":"recv-0001.doc",
                                "config":"recv-0000.cfg"
                    }]
        }
      • В File to upload через кнопку «Выбрать файлы» добавить два тестовых файла recv-0000.cfg и recv-0001.doc, необходимо добавить сразу два файла, при выборе использовать Ctrl.
      • Нажать Upload
      • Должен прийти ответ вида:
        Image Added

        Перейти по ссылке “***/fix” и скачать fix ответ.

        В логах WildFly cm.log необходимо найти две строчки по обработке файла, одна оканчивается START, другая FINISH
        Image Added
        Так же в логе указано время обработки файлов в мс. Если обе строки присутствуют - проверку можно считать успешно выполненной.

    2. Перенастроить CMJ сервер на использование данного сервера для конвертации.
      В server.properties параметр sedsvc.entrypoint.url

      Без форматирования
      # Адрес (URL) "точки входа" для СЭД-сервисов.
      sedsvc.entrypoint.url=http://<hostname>:<port>/sedsvc-war/ext-sedsvc/entry-point/

    Сборка и загрузка отчетов 

    1. Отчеты включены в сборку палитры, но они собираются отдельным пакетом cmrptpackage. Пакет находится в проекте в папке reports\target
    2. Загрузка пакета отчетов происходит через НБР-админку
      1. Перейти в раздел "Отчеты\Импорт отчетов"
      2. Выбрать пакет cmrptpackage
      3. Нажать на кнопку "Загрузить отчеты"
    3. После загрузки отчетов требуется выполнить dropcache
    панель
    titleЗагрузка отчетов

    Image Added