Загрузка данных с обложки из xlsx-файлов

Репозиторий с шаблоном разработки «Загрузка данных с обложки из xlsx-файлов».

!!! Шаблон поддерживается в версиях Directum RX до 4.9 включительно. После выхода официального релиза библиотеки ClosedXML с поддержкой DocumentFormat.OpenXml.dll версии 3.0.1 и выше возможно обновление на 4.10.

Данный шаблон был разработан на основе шаблона компании "Роса", добавлена загрузка из базы ФИАС (ГАР) справочников Населенные пункты, Поселения, Муниципальные районы и их иерархии. Данный шаблон без модификации работает при установленном решении для органов государственных власти.

Для загрузки некоторых справочников (федерального классификатора обращений, муниципальных районов, поселений) необходимо решение для органов государственной власти. Если загрузка в данные справочники не требуется, то шаблон нужно модифицировать (закомментировать функции по загрузке), чтобы использовать шаблон по назначению.

Описание

Шаблон позволяет перенести данные в Directum RX. В качестве источника данных для переноса используются книги Excel с расширением XLSX. Чтобы произвести создание записей справочников в Directum RX, достаточно заполнить специально сформированные шаблоны Excel и загрузить данные из обложки.

Шаблоны можно найти в папке Шаблоны. Общее описание и инструкцию по использованию шаблона см. тут

Шаблон отличается от утилиты https://github.com/DirectumCompany/rx-util-importdata-net-core тем, что позволяет загружать записи с обложки модуля любым сотрудником (если есть права на справочники). Также есть различия в перечне загружаемых справочников. После каждой загрузки строится отчет об успешно/неуспешно загруженных записях.

Note

Замечания и пожеланию по развитию шаблона разработки фиксируйте через Issues. При оформлении ошибки, опишите сценарий для воспроизведения. Для пожеланий приведите обоснование для описываемых изменений - частоту использования, бизнес-ценность, риски и/или эффект от реализации.

Внимание! Изменения будут вноситься только в новые версии.

Порядок установки

Для работы требуется:

1. Установленный Directum RX версии 4.6 и выше. Для более младших версий требуется модификация. Необходимо удалить/закомментировать функции, которые загружают информацию в новые справочники (Муниципальные районы, Поселения).
2. Установленное решение "Обращения граждан" (если требуется загрузка справочников федерального классификатора обращений граждан). Если данное решение не установлено, то требуется модификация. Необходимо удалить/закомментировать функции, которые загружают информацию о федеральном классификаторе обращений.

Установка для ознакомления

1. Склонировать репозиторий с rx-template-upload-data-ui в папку.
2. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.1>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': https://github.com/DirectumCompany/rx-template-upload-data-ui.git'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''

Установка для использования на проекте

Возможные варианты:

A. Fork репозитория.

1. Сделать fork репозитория rx-template-upload-data-ui для своей учетной записи.
2. Склонировать созданный в п. 1 репозиторий в папку.
3. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.2>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': https://github.com/DirectumCompany/rx-template-upload-data-ui.git'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''

B. Подключение на базовый слой.

Вариант не рекомендуется, так как при выходе версии шаблона разработки не гарантируется обратная совместимость.

1. Склонировать репозиторий rx-template-upload-data-ui в папку.
2. Указать в config.yml в разделе DevelopmentStudio:

   GIT_ROOT_DIRECTORY: '<Папка из п.1>'
   REPOSITORIES:
      repository:
      -   '@folderName': 'work'
          '@solutionType': 'Work'
          '@url': '<Адрес репозитория для рабочего слоя>'
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': ''
      -   '@folderName': 'base'
          '@solutionType': 'Base'
          '@url': 'https://github.com/DirectumCompany/rx-template-upload-data-ui.git'

C. Копирование репозитория в систему контроля версий.

Рекомендуемый вариант для проектов внедрения.

1. В системе контроля версий с поддержкой git создать новый репозиторий.
2. Склонировать репозиторий rx-template-upload-data-ui в папку с ключом --mirror.
3. Перейти в папку из п. 2.
4. Импортировать клонированный репозиторий в систему контроля версий командой: git push –mirror <Адрес репозитория из п. 1>