Паспорт шаблона разработки «Инструменты для работы с OpenXML»

Возможности решения

Решение представляет набор функциональности по заполнению основных свойств документов формата ".docx". Решение позволяет подставлять необходимые значения в элементы управления содержимым «Обычный текст», «Форматированный текст» и «Рисунок».

А также:

1. Создавать, заполнять и вставлять новые таблицы на место «Закладки».
2. Получать и изменять таблицы. 3. Вставлять новые значения/картинки в ячейки таблиц.
4. Заменять текст в теле документа.
5. Генерировать штрих/qr коды для дальнейшей подстановки в документ.
6. Добавлять подложку и изменять её значение.

Апробация на проектах

Использованные в решении подходы применялись на проектах:
• Проект 1 — Р-Фарм- Внедрение DirectumRX;
• Проект 2 — Микроген - Внедрение DirectumRX;
• Проект 3 — Мерц Фарм - Внедрение DirectumRX;
• И многих других.

Состав решения

1. Модуль OpenXML.
2. Изолированная область (AkelonOpenXMLWrapper).
3. Шаблон для демонстрации решения (создаётся при инициализации).
4. Используемые внешние библиотеки: DocumentFormat.OpenXml.dll – версия 3.0.1, DocumentFormat.OpenXml.Framework.dll – версия 3.0.1, System.IO.Packaging.dll – версии 8.0.0.
5. Обложка модуля с действием для демонстрации решения.

Варианты расширения функциональности на проектах

Самым простым способом использования данного решения является копирование необходимых методов или цепочек методов в изолированные области вашего модуля из изолированной области AkelonOpenXMLWrapper и их модификация. Так же необходимо добавить сторонние библиотеки, описанные в пункте «Состав решения».

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

Не рекомендуется модификация приватных функций решения.

Архитектурно неочевидные моменты

1. Чтобы сделать подложку иного стиля:

a) Создать новый документ и в нём настроить вид подложки.
b) Установить OpenXML SDK 2.5 и открыть с помощью него документ с нужной подложкой.
c) Найти фрагмент кода с генерацией подходящей подложки. Проще всего искать по тексту подложки.

2. Шаблон для демонстрации решения вместе с версией создаётся при инициализации. Тело документа хранится в SQL-запросе стройкой base64.