Генератор документов Pro
Модуль предназначен для быстрого решения шаблонных вопросов, связанных с подготовкой файлов.
Генератор документов формирует файлы с расширением .docx на основе созданного пользователем шаблона, подставляя в поля текстовые, табличные данные и изображения.
Описание работы (пример).
Предварительно следует создать документ с расширением .docx, который будет шаблоном для генерации файлов. В нём нужно задать имена полей для подстановки.
Имена полей задаются в фигурных скобках латинскими буквами, например: {COMP_NAME}. Расположите поля с именами переменных в нужных местах файла-шаблона, сохраните.
Совет! При работе с MacOS желательно для создания шаблонов использовать MS Word для Windows.Заполненный шаблон загрузить в систему. Сделать это можно двумя способами — загрузить на Диск в портале или в папку в административной части. Рассмотрим оба способа загрузки:
1. Зайдите в меню Диск, выберите нужную папку для шаблона и загрузите туда ваш файл-шаблон.
2. В административной части Битрикс зайдите в раздел Контент — Файлы и папки. Нажмите Загрузить файл — укажите путь к вашему шаблону.
В любом месте цепочке бизнес процесса добавьте активити «Генератор документов» (в системе он может обозначаться как Документ word из шаблона [mcart]):
Откройте настройки активити. В настройках действия Генератора прописываются поля, из которых будут браться данные для подстановки в переменные поля шаблона.
Рассмотрим подробнее поля настроек Генератора:
- Заголовок — имя данного активити. Это особенно удобно, если их несколько в цепочке бизнес-процесса. В этом случае созданные файлы с результатом будут иметь разные имена, заданные вами в настройках каждого активити;
- галочку «Обрабатывать поля в формате Merge Field» проставлять НЕ нужно;
- Путь к шаблону документа — путь к загруженному файлу с шаблоном. Например: /generator/template.docx или 523, где 523 – ID файла на диске. Если в поле прописаны буквы — модуль распознаёт путь, если цифры — находит файл с таким ID;
- Путь к сохраняемому файлу и имя — путь и название для сохраняемого файла с выходными данными и расширением .docx. Вы можете прописать здесь полный путь к файлу и формат его названия, а можете указать только название, указав путь к файлу в полях ниже. Пример заполнения: /generator/kp_{=System:Date}.docx (в данном случае имя файла будет содержать буквы kp, знак подчеркивания и текущую дату. Если вы указываете только формат названия выходного файла, например: kp_{=System:Date}.docx, то заполните нижеследующие поля:
- ID диска — ID диска, на который нужно сохранить файл результата. Как посмотреть ID диска, указано ниже.
- ID папки на диске — ID папки, в которую нужно поместить файл результата. Как посмотреть ID папки, указано ниже.
- Далее нужно добавить правила для замены переменных в шаблонном файле на данные. Для подстановки в переменные шаблонного файла в настройках действия нужно прописать правила с указанием имени переменной и имени поля, из которого будут браться данные. В левой части прописывается имя переменной в шаблоне, а в правой части — имя поля, откуда нужно взять данные. Имя поля указывается в фигурных скобках. Поле данных можно выбрать из списка, нажав на кнопку с многоточием около поля.
Внимание! Если поле документа является списком, то к правилу стоит добавить _printable. Если не выводятся другие типы полей, также попробуйте использовать приставку _printable.
Например: вместо {=Document:PROPERTY_TIP_OPLATY} укажите {=Document:PROPERTY_TIP_OPLATY_printable}.После заполнения всех полей Генератора, нажмите кнопку «Сохранить». Затем сохраните изменения, внесенные в бизнес-процесс (кнопка внизу).
Как посмотреть ID диска.
ID диска вы можете посмотреть следующим образом: в административной части Битрикс зайдите в Настройки — Таблицы — выберите в списке таблицу b_disk_storage, найдите нужный вам диск по его названию и посмотрите в соответствующей графе его ID.
Как посмотреть ID папки.
Зайдите в меню Диск, выберите нужную вам папку. Рядом с названием вы увидите поле с её ID. Если такого поля нет, зайдите в настройки и добавьте отображение этого поля.
Как вывести список строк с переходом на новую строку.
Ответ: Нужно пользоваться специальными xml тегами.
Например, воспользоваться таким тегом <w:br/>.
То есть подставляемая строка должна иметь вид:
Пункт1<w:br/>Пункт2<w:br/>Пункт3
Как добавить ссылку на сгенерированный файл
Очень часто возникает необходимость выводить ссылку на сформированный документ.
Для этого можно воспользоваться значением Ссылка для скачивания документа активити Документ Word из шаблона в Дополнительные результаты.
Ссылку можно вывести в Сообщениях Живой ленты, прописав следующие значения:
1. Вывод через тег: [url={=A14775_64625_42428_11813:Path}] ссылка [/url], где {=A14775_64625_42428_11813:Path}-выбирается через вставку значения в дополнительных результатах значение активити «Ссылка для скачивания документов»
Выводится кликабельное слово «ссылка», при нажатии на которое скачивается сгенерированный документ.
2. Вывод через системную переменную: {=System:HostUrl}{=A14775_64625_42428_11813:Path}, где
{=A14775_64625_42428_11813:Path}-выбирается через вставку значения в дополнительных результатах значение активити «Ссылка для скачивания документов»
Выводится ссылка вида :
https://название портала/disk/downloadFile/...81%29.docx
Как сгенерировать в выходном файле таблицу произвольного размера
1. Составить макет будущей таблицы в шаблонном файле. В данном примере LIST — это поле, которое нужно будет указать в настройках генератора для обращения к строковым данным массива, после точки указывается название колонки. Так, в поле list.id будут помещены данные из массива list[id] построчно. В данном примере — это порядковый номер товара в таблице.
2. Сформировать массив. Он должен иметь следующий вид:
[id] => Array
Далее построчно перечисляются все поля массива в формате:
[fio] => Array
…
[city] => Array
Количество значений в столбцах должно быть одинаковым, иначе таблица будет сформирована некорректно.
3. Сериализовать массив:
serialize(ваш_массив);
Допустим, массив был сериализован в переменную hostlist. В таком случае, настройка параметров Генератора будет выглядеть следующим образом:
LIST={=Variable:hostlist}
Сохраните настройки генератора.
Внимание! Если поле документа является списком, то к правилу стоит добавить _printable. Если не выводятся другие типы полей, также попробуйте использовать приставку _printable.
Например: вместо {=Document:PROPERTY_TIP_OPLATY} укажите {=Document:PROPERTY_TIP_OPLATY_printable}
Пример PHP-кода:
$rootA = $this->GetRootActivity();
$table_list=array (
"id" => array (1,2,3),
"fio" => array ("Иванов Иван Иванович", "Петров Петр Петрович", "Сидоров Сидр Сидорович"),
"city" => array ("Челябинск", "Владивосток", "Пермь")
);
$table_str=serialize($table_list);
$rootA->SetVariable("hostlist",$table_str);
Важно: для работы данного готового решения вам потребуется система управления Битрикс, позволяющая менять его структуру и редактировать текстовую информацию без навыков программирования.
Возможности этой системы разделены на несколько редакций, которые отличаются количеством и гибкостью функционала. Список подходящих редакций указан возле стоимости решения. Здесь же расположена кнопка со ссылкой на демо версию, перейдя по которой вы можете ознакомиться с готовым решением и попробовать его в действии.
Для создания лендинга или корпоративного сайта достаточно редакции Старт или Стандарт.
Для разработки интернет-магазина нужна редакция Малый бизнес или Бизнес.
Мы предлагаем два варианта покупки:
- Вы покупаете только решение (подходит исключительно в том случае, когда у вас уже есть система управления Битрикс в нужной редакции и ваша лицензия не просрочена).
- Вы покупаете все необходимое в одном наборе и получаете установленное и полностью готовое к работе решение на следующий рабочий день после оплаты.
- Выбранное готовое решение;
- Минимально возможная редакция Битрикс;
- Аренда хостинга;
- Бесплатная установка.
Вы можете выбрать такой набор или составить свой, добавив в него новые позиции. Например:
- Другую редакцию Битрикс с большим количеством полезных функций;
- Более мощный хостинг;
- Услуги приоритетной технической поддержки.
Положите товары в корзину, кликните по ней в правом верхнем углу страницы и выберите тип заказа.
Быстрый заказ
Позволяет пропустить стандартную процедуру оформления покупки. Вместо этого вы оставляете свои контактные данные и ожидаете звонка нашего сотрудника. Он уточняет позиции вашего заказа, отвечает на вопросы и отправляет подтверждение на вашу электронную почту.
Обычное оформление
Желательно выбирать именно его. В процессе стандартного оформления заказа, вы будете переадресованы на новую страницу. Здесь вам нужно будет выбрать тип плательщика, вариант оплаты и доставки, а также корректно указать свои контактные данные.
Правильно заполненный e-mail исключает проблему выполнения заказа с нашей стороны.
После оформления заказа вы получите от нас электронное письмо, в котором будет ссылка на оплату.
Дальнейшее информирование о стадиях выполнения заказа мы также будем отправлять вам на почту.
Оплата
Вы можете оплатить заказ по безналичному расчету или наличными при помощи банковских карт Visa, Mastercard или платежной системы LiqPay. Все позиции нашего каталога продаются без НДС, согласно раздела ХХ «Переходные положения» Налогового Кодекса Украины, подраздела 2, п. 26. Комиссия при оплате наличными не применяется.
Доставка
Купленные программные продукты будут отправлены вам по электронной почте в виде цифро-буквенного кода. Данный код является лицензионным ключом и выписывается автором купленного программного продукта.
Он предоставляет вам официальное право на его использование.
Установка
В стоимость программных продуктов входит их бесплатная установка.
Если у вас уже есть сайт на Битрикс и вы хотите установить купленное решение на той же лицензии на отдельном домене, такая установка оплачивается дополнительно.
Безналичный расчет
Данный способ оплаты доступен для физических и юридических лиц. После заполнения и подтверждения заказа вы получите по e-mail счeт-оферту со всеми реквизитами, которую необходимо распечатать и оплатить в любом коммерческом банке в течение 5 банковских дней с момента оформления заказа.
Пожалуйста, обратите внимание, что продажа программных продуктов осуществляется без НДС, согласно раздела
ХХ «Переходные положения» НКУ, подраздела 2, п. 26. После оплаты вы получите по почте счет и акт об оказании услуг. Пожалуйста, подпишите данный акт, поставьте печать и отправьте нам один экзмпляр.
Оплата с помощью платежных карт Visa и Mastercard
Этот способ оплаты доступен для физических лиц (комиссия за перечисление денег не взымается). Для защиты платежей используется технология 3-D Secure, которая лежит в основе программ Verified by Visa и MasterCard SecureCode. Она гарантирует и покупателю, и продавцу полную безопасность операций. Наш банк-эквайер имеет сертификат PCI DSS Compliance, подтверждающий полное соответствие системы обработки платежных карт банка требованиям стандарта безопасности международных платежных систем PCI DSS.
После заполнения и подтверждения заказа вы будете переадресованы на защищенную страницу веб-сайта банка, где и укажете реквизиты карты для оплаты, при этом обмен информацией будет произведён с помощью промышленных форматов шифрования.
Оплата с помощью платeжной системы LiqPay
Данный способ оплаты доступен для физических лиц (комиссия за перечисление денег не взымается). Высокий уровень безопасности обеспечивается технологией OTP (One-time Password). Надёжность и безопасность приёма платежей подтверждена международными сертификатами Verified by Visa и MasterCard SecureCode. «Приватбанк» обеспечивает круглосуточный мониторинг платежей клиентов в режиме реального времени.
После заполнения и подтверждения заказа вы будете переадресованы на защищенную страницу веб-сайта сервиса LiqPay, где и укажете реквизиты карты или своего внутреннего счёта для оплаты.
Доставка
Купленные программные продукты поставляются в виде цифро-буквенного кода, используя который их можно установить на хостинг согласно инструкции. Код отправляется онлайн на указанную в заказе электронную почту.
После получения оплаты и до момента отправки лицензионного ключа может пройти несколько часов.
На протяжении этого времени проводится оформление купленной продукции на ваше имя.
Внимание! Неправильно указанный e-mail может привести к дополнительной задержке.
Пожалуйста, проверяйте ваши персональные данные при регистрации и оформлении заказа.
Для установки вам потребуется:
- Система управления Битрикс (подходящей редакции);
- Домен;
- Хостинг.
При покупке готового набора, установку мы сделаем для вас бесплатно.
Инструкция по установке системы управления Битрикс:
- Зарегистрируйте лицензионный ключ на
сайте Битрикс (придет на ваш e-mail после покупки).
Он состоит из 23 символов прописных (больших) букв латинского алфавита и цифр в формате:
XXX-XX-XXXXXXXXXXXXXXXX. - Скачайте на компьютер установочный файл.
- Авторизируйтесь на сайте хостинг провайдера (логин и пароль придет на ваш e-mail после покупки).
- Войдите в файловый менеджер и загрузите установочный файл в корневую папку хостинга.
- Создайте новую базу данных.
- Перейдите по адресу тестового домена по ссылке имя-сайта/bitrixsetup.php
- В окне установки выберите редакцию, соответствующую вашему лицензионному ключу.
- В поле «Лицензионный ключ» вставьте код, который пришел вам на e-mail после покупки.
Он состоит из 23 символов прописных (больших) букв латинского алфавита и цифр в формате:
XXX-XX-XXXXXXXXXXXXXXXX. Нажмите кнопку «Загрузить». - На экране «Начало установки» нажмите кнопку «Далее».
- Поставьте галочку в пункте «Я принимаю лицензионное соглашение» и нажмите кнопку «Далее».
- Поставьте галочку в пункте «Я хочу зарегистрировать свою версию продукта", заполните обязательные поля.
Если планируете делать сайт на иностранном языке, отметьте пункт «Установить в кодировке UTF-8», нажмите кнопку «Далее». - На экране «Предварительная проверка системы» вы увидите показатели вашей системы управления.
Показатели зелёного цвета соответствуют требованиям. Красные - нет.
Для исправления красных значений обратитесь в техподдержку вашего хостинг провайдера. - На экране «Создание базы данных» впишите данные созданной на хостинге базы данных.
- Создайте администратора сайта, заполнив все обязательные поля.
- Выберите шаблон для установки на сайт: либо бесплатный шаблон, либо купленное готовое решение.
Инструкция по установке готового решения:
- Установите на хостинг систему управления «Битрикс».
- Перейдите по ссылке: имя-сайта/bitrix и авторизируйтесь под данными администратора.
- Перейдите в административную панель в раздел Marketplace и подраздел «Обновление решений».
Откройте вкладку «Активация купона». - Введите в поле купон, который пришел вам на e-mail после покупки решения.
Он состоит из 25 символов прописных (больших) букв латинского алфавита и цифр в формате:
XXX-XXXXXXXXXX-XXXXXXXXXX. Нажмите кнопку «Активировать купон». - Название решения появится во вкладке «Список обновлений». Отметьте его галочкой и загрузите.
- Откройте вкладку «Установка обновлений» и установите.
- Найдите появившееся название купленного решения и в выпадающем списке выберите пункт «Загрузить».
- Перейдите в разделе «Настройки» в подраздел «Список мастеров», найдите название купленного решения и в выпадающем списке выберите пункт «Установить».
- Откроется мастер установки готового решения.
- Выберите пункт «Существующий» для установки решения первым сайтом на лицензии, нажмите «Далее».
- На экране «Выбор шаблона» нажмите «Далее».
- Выберите цветовую схему сайта, нажмите «Далее».
- Замените демо данные сайта, нажмите «Установить».
- На экране «Завершение настройки» нажмите «Перейти на сайт».
Задать вопрос
Не нашли ответа на свой вопрос?Свяжитесь с нами, и мы предоставим необходимую информацию. |
Задать вопрос
|