rx-util-importdata-net-core

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

Описание

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

Note

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

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

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

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

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

1. Организации (Контрагенты).
2. Наши организации.
3. Подразделения.
4. Должности.
5. Сотрудники.
6. Персоны.
7. Контактные лица.
8. Учетные записи (логины). Важно: новые записи создаются только с внешней аутентификацией.
9. Страны;
10. Валюты;
11. Приложений-обработчиков;
12. Категорий;
13. Журналов регистрации;
14. Видов документов;
15. Ролей;

Модификация

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

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

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

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

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

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

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

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

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