rx-util-importdata-net-core

Репозиторий с шаблоном разработки «Утилита импорта данных».

Описание

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

Note

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

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

На текущий момент реализована возможность импорта следующих типов документов:

1. Договоры.
2. Дополнительные соглашения.
3. Приложения к договорам.
4. Акты выполненных работ.
5. Входящие письма.
6. Исходящие письма.
7. Импорт табличной части Адресаты для сущности Исходящее письмо.
8. Приказы.
9. Распоряжения.
10. Простые документы.
11. Накладные.
12. УПД.

Справочников:

1. Организации (Контрагенты).
2. Наши организации.
3. Подразделения.
4. Сотрудники.
5. Персоны.
6. Контактные лица.
7. Учетные записи (логины). Поддерживается создание с внешней (Windows) и парольной (Password) аутентификацией. Тип определяется наличием пароля в шаблоне.
8. Страны.
9. Валюты.
10. Приложений-обработчиков.
11. Категорий договоров.
12. Журналов регистрации.
13. Видов документов.
14. Ролей.
15. Замещений.
16. Номенклатуры дел.
17. Услуг (ESM).
18. Категорий услуг (ESM).
19. Конфигурационных единиц (CMDB): единицы, категории, виды, жизненные циклы, связи и типы связей.

Режимы работы

Утилита поддерживает два режима:

• CLI — консольное приложение, запускается из командной строки с параметрами (start.bat / start.sh).
• Web UI — браузерный интерфейс на базе Blazor WebAssembly + ASP.NET Core. Запускается из src/Client/ImportUtilServer, доступен по адресу http://localhost:5000.

Модификация

Для модификации утилиты требуется наличие на рабочем месте разработчика:

1. Visual Studio 2017 и выше.
2. Установленый пакет .net 6.0 и выше.

Модификация выполняется за счет наследования и доработки реализованных классов:

• класс Entity — базовый абстрактный класс, от которого наследованы остальные классы;
• классы справочников (Databooks): AssociatedApplication, BusinessUnit, CaseFile, Company, ConfigurationItem*, Contact, ContractCategory, Country, Currency, Department, DocumentKind, DocumentRegister, Employee, Login, Person, Role, Service, ServiceCategory, Substitution — реализуют процесс импорта исторических данных в справочники системы Directum RX;
• класс DocumentEntity — базовый абстрактный класс, от которого наследованы остальные классы документов, наследник Entity;
• классы документов (EDocs): Addendum, CompanyDirective, Contract, ContractStatement, IncomingLetter, Order, OutgoingLetter, OutgoingLetterAddressees, SimpleDocument, SupAgreement, UniversalTransferDocument, Waybill — реализуют процесс импорта документов с телами (или без тел) в систему Directum RX;
• методы, которые прямо не относятся к классам сущностей реализуются в классе BusinessLogic;
• механизмы работы с XLSX реализованы в классе ExcelProcessor. В качестве механизма работы с XLSX используется библиотека OpenXml;
• общие механизмы работы с сущностями реализованы в классах EntityProcessor и EntityWrapper.

Порядок установки и использования

Порядок установки и использования описан в документе Утилита импорта 4.1. Инструкция по загрузке данных.pdf

Порядок кастомизации утилиты (для партнеров)

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

1. В системе контроля версий с поддержкой git создать новый репозиторий.
2. Склонировать репозиторий https://github.com/DirectumCompany/rx-util-importdata-net-core.git в папку с ключом --mirror.
3. Перейти в папку из п. 2.
4. Импортировать клонированный репозиторий в систему контроля версий командой: git push –mirror <Адрес репозитория из п. 1>