Генерация документов на основе Excel шаблона

Очень часто при автоматизации бизнес процессов требуется формировать электронные документы на основе структурированных данных. Источником структурированных данных обычно являются справочники системы DIRECTUM. Потребность формирования электронных документов возникает по следующим причинам:

• Электронный документ - удобное представление для согласования информации. Возможность отображать данные из нескольких источников данных;
• Возможность установки ЭЦП - дополнительная защита результатов согласования;

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

• Высокая трудоемкость разработки, которая обычно связана с необходимостью программирования визуальной части отчета. Это относится к rtf и Excel/html отчетам в системе DIRECTUM.
• Шаблон отчета находится в разработке, что не позволяет пользователям системы изменять настройку представления. Например, заказчики часто хотят добавлять в отчеты, генерируемые системой, свой логотип.

Предлагаю использовать альтернативный вариант формирования электронных документов на основе Excel шаблона, который решает описанные выше недостатки. Механизм основан на возможности Excel использовать элементы присоединенной XSD схемы данных для разметки шаблона. Возможность доступна начиная с версии Excel 2003.

Приведу пример разметки шаблона документа «Выписка по счету» в Excel 2007. Путь до опции подключения XSD схемы данных: Вкладка разработчик(на риббоне)\Источник\Карты XML…\Добавить. Откроется диалоговое окно для выбора файла с описанием схемы данных. После подключения схемы в разделе «Источник XML» появится элементы подключенной XSD схемы, которые можно перенести в любую ячейку шаблона:

XSD схема – это обычный XML файл, в котором описаны элементы данных. XSD схема для приведенного примера выглядит следующим образом:

Для формирования XSD схемы рекомендую использовать инструменты Visual Studio 2008, но можно сделать и в обычном текстовом редакторе.

После того, как шаблон настроен и выполнена разметка полей данных его можно сохранить в системе и в установки вынести параметр, к которому можно будет привязаться в разработке ISBL. Для того, чтобы программно создать электронный документ на основе настроенного шаблона, нужно сделать следующее:

1. Подготовить XML файл с данными, соответствующий подключенной XSD схеме шаблона. XML данные для описанной в примере XSD схемы будут выглядеть следующим образом:

Формирование XML документа на ISBL нужно выполнить с помощью библиотеки msxml.dll:

…
REPORT_NAME = “ВыпискаПоСчету_карта” 
XMLDocument = CreateObject("MSXML.DOMDocument")
ProcInstruction = XMLDocument.CreateProcessingInstruction("xml"; 'version="1.0" encoding="windows-1251" standalone="yes"')
XMLDocument.appendChild(ProcInstruction)
RootElement = XMLDocument.CreateElement(REPORT_NAME)
XMLDocument.appendChild(RootElement)
…

2. Получить шаблон документа и экспортировать его на диск.

…
TemplateID = Конст(‘xxx’)
Template = Edocuments.GetObjectByID(TemplateID)
Template.Export(VersionNumber; Path; FALSE)
…

3. Открыть экспортированный шаблон в Excel и передать в него подготовленные данные:

…
Excel = CreateObject("Excel.Application")  
Book = Excel.WorkBooks.Open(Path)
Sheet = Book.WorkSheets(1)
// Загрузка данных в Excel
XmlMap = Book.XmlMaps(REPORT_NAME)
XmlMap.ImportXML(XMLDocument.xml)
Book.Save
Book.Close
Excel.Quit
…

4. При необходимости открыть документ для просмотра либо сразу сохранить документ в хранилище системы DIRECTUM.

Пример сформированного документа «Выписка по счету»:

Кроме экспорта данных в шаблон Excel можно выполнить и обратное действие – импортировать данные из полей разметки шаблона. Т.е. в этом сценарии работы шаблон Excel будет выступать в качестве электронной формы для ввода данных, которые можно будет импортировать в систему DIRECTUM.

scheme.zip (531,00 байт)