Генерация документов Docx и Xlsx. Выгрузка Excel, Word по шаблону

Компонент Выгрузка документов позволяет создать некий шаблон Excel или Word, вставить в него параметры вида {tableN.colName} и затем по кнопке генерировать файлы из шаблона.

Выполняется некий запрос (возращающих несколько SELECT), эти данные передаются в обработчик, которые подставит их в файл-шаблон и выдаст ссылку на новый файл пользователю. 

Т.е. задача разработчика заключается в следующем: 

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

Пример выгрузки документов Excel и Word

Компонент позволяет сформировать документ Word или Excel на основе документа-шаблона со вставкой в него данных из хранимой процедуры.

Сниппет
<a href="#" class="as-doc" data-code="code" data-itemid="123" title="Генерация документа Акта"><i class="fa fa-file-text"></i></a><i class="fa fa-file-text">
<!--При нажатии на ссылку формируется документ и выдается ссылка на скачивание.--></i>

Должен быть создан элемент Документа в БД (раздел Выгрузка документов) с элементами: 

• Код - является частью названия хранимой процедуры извлечения данных, а также названием шаблона документа. 
• Название - участвует в формировании названия выходного файла 
• Тип - Word или Excel
• Роли - какие роли имеют доступ к документу. 

Далее создаем хранимую процедуру с именем doc_{code}_getData, которая возвращает наборы данных (несколько select).

ALTER PROCEDURE [dbo].[doc_testWord_getData]
   @username nvarchar(64),
   @itemID int,
   @urlParameters CRUDFilterParameter READONLY
AS
BEGIN
  select 1 Result, '' msg, '8000' TableWidth, '2500,1000,3500' ColWidths, '999999' TableHeaderBackColor, 'Акт-{g}' FileName

	select 'ИП Федоров А.И.' customer, '241' docNum, '10 ноября 2019г.' date,
    	'Договор №3 от 01 ноября 2019г.' parentDoc,
        '550 (пятьсот пятьдесят) рублей' propis,
        'Индивидуальный предприниматель' customerPost,
        'Федоров Алексей Иванович' customerFIO,
         '2019' year

	select 'Покраска стен' as 'Работы', 12 as 'Метры', 250 as 'Стоимость'
    union
    select 'Укладка ламината',20, 300

END

• {table2} - вставить целиком вторую таблицу (второй select).
• {table2.title} - вставить значение колонки title из 1 строки второго набора (SELECT 2).  (также можно {table1.title.text})
• {table2.code1.img} - вывести картинку
• {table2.code1.ul} и {table2.code1.ol} - вывести ненумернованный и нумерованный список (при этом в поле SQL значения будут перечислены через ||). 

Примечание

1. Для шаблона Docx любые коды вставлять только через буфер обмена из блокнота (и не редактировать в Word). Это связано с особенностью хранения в Word структуры XML в виде P, run и text тегов. Для таблиц ({table1}) - обязательно только один элемент должен быть в строке (без дополнительного текста). Если где то не срабатывает шаблон - попробуйте вставить полный кусок текста с параметрами прямо из блокнота 
2. При генерации документов сохраняется лог, кто, когда создавал файлы с ссылкой на сформированный файл. 
3. Генерируемые файлы находятся по адресу /uploads/doc/{code} + в название добавляется суффикс miniGuid.
4. Если необходимо проверить более детально права на формируемый документ - это можно сделать прямо в хранимой процедуре GetData на основе username и itemID.
5. Также вы можете генерировать документы через Внешнее действие generatedoc (при этом дополнительные данные передаются в в GetData процедуру через параметр ExtendedDictionaryParameter @parameters). См. подробнее про Внешние действия.
6. Выходные данные из SELECT лучше сразу приводить к строке в явном виде и обрабатывайте ситуацию с null (через isnull).

Как вставлять картинки в генерируемый Excel 

Для этого параметры указываем с префиксом img_ 

Пример: 

select  '{"path": "/uploads/5.jpg", "name":"Name11",   "height": 50, "width": 200,
            	"barcode":{ "value": "123", fontSize: 45, font: "", backColor: "white", "width": 200, "height": 50 } }' as img_col1 

В файле Excel указываем {table1.img_col1}. 

В этом месте выведется указанная картинка (либо сгенерированный штрих код). 

Параметры: 

• path - путь к файлу
• name - наименование объекта в Excel
• height, width - размер картинки (например 200, 300)
• scale - указывает масштаб вывода картинки (например 0.5)
• barcode - настройка для генерации штрихкода (в этом случае path можно оставить пустым). Его параметры:
  • value - что кодируем в штрих коде
  • fontSize - размер выводимого штрих кода
  • font - название спец шрифта для вывода штрих кода, например font39. 
  • backColor - какой будет фон у штрих кода (white, yellow и т.д.)
  • width, height - размеры картинки штрих кода. 
• barcode2 - альтернативный вариант генерации (через доп библиотеку, а не штрифт на сервере). Его параметры:
• value - что кодируем в штрих коде
• pureCode - bit. Если 0, то с кодом будет внизу выводится сама закодированная строка. Если 1 - то выводится только сам штрих код.
• width, height - размеры картинки штрих кода. 

Примечание: 

• Для параметра barcode должен быть установлен (открыть файл ttf и кнопка Установить) штрифт font39 на сервере или другой аналогичный шрифт для вывода штрих кодов.  Шрифт есть в папке /content/fonts. После установки шрифта нужно перезагрузить IIS на сервере.
• Параметр barcode2 используйте, когда нет возможности установить шрифт на сервере (например, это win хостинг).