Модуль предназначен для быстрого решения шаблонных вопросов, связанных с подготовкой файлов.
Генератор документов формирует файлы с расширением .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);
Приобретенные программные продукты поставляются в виде цифро-буквенного кода. Используя код, вы сможете установить продукт на хостинг. Код приходит на указанный в заказе адрес электронной почты.
Время от момента получения оплаты до момента отправки кода составляет несколько часов. В течение этого периода выполняет оформление приобретенной продукции.
Обращаем ваше внимание, что дополнительная задержка может быть вызвана некорректно указанным адресом почты. Просим вас внимательно проверять ваши персональные данные при оформлении заказа. Мы гарантируем, что конфиденциальность ваших данных будет соблюдена.
Что требуется для установки:
- CSM «1С-Битрикс».
- Домен.
- Хостинг.
Мы предлагаем приобрести все необходимое в готовом наборе на нашем сайте. Это позволит ускорить дальнейшую установку.
Бонус: бесплатная базовая установка!
Чтобы получить подробную информацию о сервисе, вы можете ознакомиться с официальными реестрами Visa International и MasterCard Worldwide. Заполнив и подтвердив заказ, вы будете переадресованы на сайт сервиса Яндекс.Деньги. Там вы сможете оплатить заказ, воспользовавшись картой Visa, Mastercard или Maestro или кошельком Яндекс.Деньги.
Подробнее
1. Скачайте решение на Маркетплейсе.
2. Укажите путь для установки, нажмите Установить.
3. В административной части Битрикс нажмите Загрузить, затем Установить.
4. После окончания установки в Дизайнере бизнес-процессов появится новое действие – Генератор документов (в системе он может обозначаться как Документ word из шаблона [mcart]).
Внимание! Для корректной работы модуля в настройках php нужно включить расширения zip, xmlwriter и dom.
zip
если расширение php-zip не установлено, то устанавливаем
yum install php70*zip
если расширение уже установлено, то нужно подключить его в файле /etc/php.d/40-zip.ini, прописав там:
; Enable ZIP extension module
extension=zip.so //либо другой путь к zip.so (можно найти поиском), например extension=/opt/remi/php70/root/lib64/php/modules/zip.so
xmlwriter и dom
В папке /etc/php.d/ нужно перенести содержимое файла
20-xmlwriter.ini.disabled в 20-xmlwriter.ini
20-dom.ini.disabled в 20-dom.ini
Не забудьте перезагрузить веб-сервер и проверить применение настроек через phpinfo -i
Обратите внимание! Наши решения разработаны для сайтов/порталов с кодировкой UTF-8.
Модуль работает с версиями битрикса от 23.300.
- Исправлена ошибка генерации пути полученного файла
- Устранена ошибка, которая возникала при добавлении активити в БП несколько раз.
-
Исправленна проблема при которой в таблицу добавляеться только первый элемент
-
Исправлен вызов метода loadXML()
-
Исправлен вызов метода loadXML()
- Модуль переведен на PHP 8.
- Устранена проблема с зацикливанием колонок при создании таблиц
-
Модуль переведен на PHP 8.
-
Модуль переведен на PHP 8.
- Устранена проблема с зацикливанием колонок при создании таблиц
Это заранее созданный сайт или интернет-магазин с демоконтентом, лид-формами и кнопками, который вы можете купить и использовать для своего проекта.
В будущем готовое решение можно доработать, обратившись к программистам.
В стоимость готового решения входят такие позиции:
- Шаблон дизайна.
- Набор цветовых схем.
- Запрограммированные веб-страницы.
- Демоконтент.
- Структура меню.
- Мастер установки.
Кроме приобретения решения для разработки сайта также понадобятся:
- Система управления контентом «Битрикс».
- Аренда домена и хостинга.
Список подходящих редакций указан на детальной странице каждого решения. Если рассматривать редакции с точки зрения функционала, то можно выделить две группы:
- Редакции для разработки лендингов и корпоративных сайтов.
- Редакции для создания интернет-магазинов.
Для разработки одностраничников и корпоративных сайтов подходят редакции «Старт» и «Стандарт». «Стандарт» отличается от «Старта» наличием модуля проактивной защиты. Что входит в модуль:
- Инструмент для проведения аудита.
- Панель безопасности с разными уровнями защищенности.
- Антивирус.
- Система одноразовых паролей.
- Защита от DDoS-атак.
- Журнал вторжений и др.
С помощью этих редакций можно создать интернет-магазин, но в этом случае вам понадобится модуль корзины, не входящий в комплектацию редакций. Такой модуль включен в состав некоторых готовых решений. Оптимальный вариант для разработки интернет-магазина - это редакции «Малый бизнес» и «Бизнес», поддерживающие интеграцию с 1С.
В каких случаях нужна редакция «Бизнес»:
- Если у вашего интернет-магазина несколько групп покупателей (например, оптовые и розничные), для которых должна быть разная цена на одинаковый товар.
- Для запуска программ лояльности, систем скидок и бонусов.
- Для магазинов, в которых продаются наборы (основной товар + аксессуары).
- Для магазинов, продающих комплекты из основной позиции и актуального (но не обязательного для использования товара).
- Для тех, кто распоряжается несколькими складами или оффлайн-магазинами (информация о наличии товара должна отображаться в интернет-магазине).
Если у вас нет необходимости в перечисленных возможностях, то вы можете выбрать редакцию «Малый бизнес». В будущем ее можно расширить до более полной редакции «Бизнес», внеся дополнительную плату.
Нет, для установки решения требуется активная лицензия, то есть с момента приобретения прошло менее 12 месяцев. После истечения этого срока лицензию необходимо продлить.
Вы можете продлить лицензию, воспользовавшись одним из двух тарифов - льготным или стандартным. Льготный тариф действует в течение 30 дней после окончания лицензии (его стоимость составляет 22% от ее цены). Стандартный тариф составляет 60% от базовой цены и действует, если после окончания прошло более 30 дней.
Да, мы можем установить решение на лицензию «Битрикс». Возможна бесплатная установка, начиная с лицензии «Малый Бизнес». Для этого вы предоставляете:
- Ссылки на хостинг, логин и пароль (это необходимо для авторизации).
- Доменное имя.
- Лицензионный ключ «Битрикс».
- Купон для установки.
- Зарегистрируйте лицензионный ключ на сайте Битрикс (придет вам по e-mail после покупки). Он состоит из 23 символов прописных (больших) букв латинского алфавита и цифр в формате: XXX-XX-XXXXXXXXXXXXXXXX.
- Скачайте установочный файл на свой компьютер.
- Зайдите на сайт хостинг-провайдера и авторизуйтесь.
- Войдите в файловый менеджер. Там вы сможете загрузить установочный файл в корневую папку хостинга.
- Сформируйте базу данных.
- Перейдите по адресу тестового домена, воспользовавшись ссылкой имя-сайта/bitrixsetup.php.
- Выберите редакцию, которая соответствует отправленному вам лицензионному ключу.
- Воспользуйтесь отправленным на вашу почту 23-значным кодом и вставьте его в поле «Лицензионный ключ». Нажмите на кнопку «Загрузить».
- После того, как появится экран «Начало установки», кликните кнопку «Далее».
- Выберите пункт «Я принимаю лицензионное соглашение», поставьте галочку и кликните кнопку «Далее».
- Выберите пункт «Я хочу зарегистрировать свою версию продукта» и поставьте галочку. Не забудьте о заполнении обязательных полей. При создании сайта на иностранном языке поставьте отметку в пункте «Установить в кодировке UTF-8» и кликните «Далее».
- Перед вами появится экран для предварительной проверки системы. На нем вы увидите показатели вашей редакции. Выделенные зеленым цветом показатели соответствуют требованиям, а красным - не соответствуют. Чтобы исправить несоответствующие значения обратитесь в техподдержку хостинговой компании.
- На появившемся экране «Создание базы данных» внесите необходимые данные (база создается на хостинге).
- После заполнения всех обязательных полей вы можете создать администратора сайта.
- Воспользуйтесь шаблоном для установки. Вы можете выбрать как бесплатный шаблон, так и готовое решение.
Следуйте инструкции:
- Установите на хостинг систему «Битрикс».
- Авторизуйтесь под данными администратора, выполнив переход по ссылке имя-сайта/bitrix.
- В разделе Marketplace вы увидите административную панель. Перейдите в нее и выберите подраздел «Обновление решений». После этого откройте вкладку «Активация купона».
- Купон - это 25 символов (цифры и заглавные буквы латинского алфавита). Введите купон для активации и кликните «Активировать купон».
- После того, как в «Списке обновлений» появится название решения, поставьте галочку и загрузите его.
- Откройте вкладку «Установка обновлений» и установите.
- Выберите название купленного решения и отметьте пункт «Загрузить».
- В разделе «Настройки» найдите подраздел «Список мастеров». Найдите название вашего решения и отметьте пункт «Установить».
- После того, как появится мастер установки, отметьте пункт «Существующий» и нажмите «Далее».
- На экране «Выбор шаблона» кликните «Далее».
- Выбрав цветовую схему, нажмите «Далее».
- Замените демоконтент и кликните «Установить».
- На появившемся экране «Завершение настройки» кликните «Перейти на сайт».
Стоимость не всегда зависит от наличия хостинга. По своему опыту можем сказать, что не все хостинги одинаковы. В некоторых ситуациях параметров хостинга недостаточно для корректной работы сайта и обеспечения рекламной кампании. Если вы пользуетесь услугами провайдеров Timeweb, Ru-Center или Rusonyx, то стоимость будет снижена на ту сумму, которая была потрачена на хостинг. В ином случае советуем обратиться к менеджеру для уточнения деталей.
Владельцам небольших проектов мы предлагаем простые тарифы хостинга для снижения расходов.
Общие для всех продуктов:
- Обновление продукта;
- Получение новых версий (можно посмотреть какие и как часто выходят обновления для Управления сайтом и для Битрикс24);
- Приоритетная техническая поддержка в первую очередь (срок ответа не превышает шести рабочих часов);
- Система резервного копирования в облако;
- Использование Маркетплейс
- Конструктор Сайты24
Уникальные для «1С-Битрикс: Управления сайтом»
- Обновление системы безопасности;
- Инспектор сайтов;
- Ускорение загрузки сайта CDN
- Мобильное приложение администратора магазина (для редакций «Малый бизнес» и «Бизнес»)
- Автобюджет контекста в Яндекс.Директ
- BigData: Персонализация
- Защита от DDoS
Уникальные для «1С-Битрикс24»
- Работа телефонии
- Автозаполнение реквизитов по ИНН
- Работа открытых линий:
- настраивать и создавать Открытые линии можно без ограничений;
- онлайн-чат работает без ограничений;
- каналы коммуникаций исчезают из виджета CRM;
- сообщения на портал из настроенных каналов продолжают приходить;
- настроить каналы нельзя - будет выдаваться ошибка (кроме Онлайн-чата);
- нельзя ответить на сообщения - они не доставляются.
Даже если вы не приобретете продление на следующий год, то по истечение года активности лицензии сайт не отключится и продолжит работать.
Теперь немного подробнее как происходит лицензирование с юридической точки зрения.
После оплаты права использования программы, вы одновременно получаете две лицензии:
1. Стандартную – она позволяет использовать продукт, получать обновления, устанавливать решения из Маркетплейс, приоритетную техническую поддержку и т.д. (то о чем говорилось вначале). Срок действия Стандартной лицензии – один год. После этого необходимо продление.
2. Ограниченную – которая дает право использовать продукт без доступа к обновлениям и решениям из Маркетплейс. Владелец Ограниченной лицензии, если срок его Стандартной лицензии истек, получает техническую поддержку менее оперативно (срок ответа – до трех рабочих дней).
Ограниченная лицензия предоставляется не по письменному договору, а по EULA (лицензионное соглашение с конечным пользователем) и не учитывается в бухгалтерском учете. Ее назначение – подтверждение правомерности использования программного продукта клиентом по истечению годичного периода.
Срок действия Ограниченной лицензии совпадает со сроком исключительных прав на программный продукт (по статье 1281 ГК РФ).
Как осуществляется поставка? Получу ли я коробку/диск?
Все продукты «1С-Битрикс» поставляются в электронном виде по электронной почте. После подтверждения факта оплаты на e-mail, указанный при оформлении заказа, будет отправлено письмо с лицензионным ключом, инструкцией по его активации и получению дистрибутива, или купоном и инструкцией по активации купона.
Поставка программных продуктов "1С-Битрикс" на физических носителях (коробки/диски) не осуществляется.
После оплаты лицензионного вознаграждения вам предоставляется право использования ПО (авторизационный код/ключ) - договор считается исполненным. Согласно п. 4 ст. 453 ГК РФ: "Стороны не вправе требовать возвращения того, что было исполнено ими по обязательству до момента изменения или расторжения договора, если иное не установлено законом или соглашением сторон."
Поставка программных продуктов "1С-Битрикс" на физических носителях (коробки/диски) не осуществляется.