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

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

Ключ

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

Оглавление

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

Статус
colour

Yellow

View file
nameinstall plugin.mp4
height150
View file
nameimport.mp4
height150
View file
namebuild.mp4
height150

View filenameexport.mp4height150

Green
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

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

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

  1. Установить JDK 1.8. Не забыть установить переменные среды.
  2. Скачать средство сборки проектов Apache Maven (из репозитория) и расположить в папке C:\Program Files\Maven\ . ВАЖНО! При расположении в другой папке нужно в файле ...\apache-maven-3.8.4\conf\settings.xml зменить путь параметра localRepository.
    Установить переменные среды окружения M2, M2_HOME, MAVEN_HOME, добавить MAVEN_HOME в список путей в переменной Path.
  3. В корень диска C: кладутся :
    - папка cm-config. На неё будут ссылаться переменные в standalone.xml сервера приложений Wildfly.
    - папка cm5. Она содержит пустые папки, которые будут использоваться для хранения файлов в системе.
  4. Установить PostgreSQL версии 13 (https://www.postgresql.org/download/windows/, в репозитории есть нужная версия 13.2.2, которая точно работает) вместе с встроенным приложением pgAdmin. Создать пользователя с именем "admin" и паролем "admin", выдать ему максимальные права.
    Создать 2 базы данных:  cm7_af5, cm7_cmj, владельцем должен быть admin. Запустить pgAdmin, восстановить базы данных из бэкапов(есть в репозитории). Image RemovedImage Removed
  5. Скачать из репозитория сервер приложений 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
  6. Установить Intellij IDEA Ultimate Edition (является платной версией) или Spring Tool Suite (https://spring.io/tools). Установку и запуск среды раработки производить от имени администратора.
  7. Скачать репозиторий проекта используя GitExtentions версии 2.50.02. Открыть проект с помощью среды разработки.
  8. В среде разработки:
    - настроить путь к JDK
    - установить VM Options: -Dmaven.test.skip -DskipTests -Dmaven.javadoc.skip=true -Denforcer.skip=true -Xmx8192m
    - настроить автоматическое форматирование кода:  файл для Intellij IDEA прилагается.
    - настроить Maven как срество сборки проекта. Указать устанорленный экземпляр. 
        User settings file = C:\Program Files\Maven\apache-maven-3.5.2\conf\settings.xml
        Local repository = C:\Program Files\Maven\repository

    Image RemovedImage RemovedImage RemovedImage Removed

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

JasperReports

ГОТОВО

Комментарий

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

Установить 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