Антон Горбылев (Все сообщения пользователя)

1.  
Оптимальный вариант будет следующий:
При клике на кнопку "Документ" в первый раз идёт аякс-запрос на получение списка доступных шаблонов. На js аякс вызывается тут

BX.DocumentGenerator.Button.init
documentgenerator/install/js/documentgenerator/documentprevi­ew.js:634

На php этот запрос обрабатывается тут \Bitrix\DocumentGenerator\Controller\Document::getButtonTemplatesAction()

Вам надо перехватить событие onAjaxSuccess, в этом событии по урлу определить, что это нужный запрос, и в обработчике переопределить список шаблонов (видимо, придётся сделать ещё один аякс запрос). Больше ничего делать не надо, можно вообще никуда не лезть


2. вам надо сделать запрос к методу crm.documentgenerator.document.list

3. Через активити показать слайдер с документом конечно не получится. Может и есть способ, но мне не известен



Если нужен именно рест, то вам нужен метод crm.documentgenerator.document.list https://dev.1c-bitrix.ru/rest_help/crm/documentgenerator/documents/crm_documentgen­erator_document_li... (там есть пример с фильтром)

Ссылка на просмотр существующего документа crm в слайдере имеет вид

/bitrix/components/bitrix/crm.document.view/slider.php?documentId=10&IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER

чтобы в слайдере начался процесс генерации нового документа ссылка должна быть такой

/bitrix/components/bitrix/crm.document.view/slider.php?providerClassName=Bitrix\Crm\Integration\DocumentGenerator\D­ataProvider\Deal&templateId=1&value=1&analyticsLabel=generateDocument&templateCode=BILL_RU&IFRAME=Y&IFRAME_TYPE=SIDE_SLIDER

здесь надо подставить нужный провайдер, ид шаблона и ид сущности

В обработчике события onBeforeProcessDocument нельзя подменить шаблон.


Для реализации такой логики вам лучше сделать создание документа через активити "Создание документа CRM".

Вы можете перед этим активити проверять ваши условия, в зависимости от них записать ид нужного документа в переменную и передать его в активити создания документа.

Другой вариант - подсовывать какую-то свою логику на js.

Добрый день.


Чтобы новое поле добавилось в документ, вам надо передать его описание.

В конце обработчика события добавьте следующее


а в сам шаблон добавьте поле {ProductsProductW4aTutut}

В этом случае его значение появится в документе. Локально проверил, работает

Игорь Акинфиев, код из предыдущего примера должен работать. Можете подебажить стандартный механизм создания документа (через интерфейс) и посмотреть. Там также работает.


Ваш вариант с использованием апи корректный, файл будет создан. Но это просто файл, он его даже в базу не сохранит. Ни как файл, ни как документ.

Попробуйте воспользоваться стандартным активити, а данные в документ подсовывайте на событии onBeforeProcessDocument. Код тот же самый, но всё остальное должно работать.

Игорь Акинфиев, проверьте, что ваш шаблон с ид 42 привязан к сущности "счет". Проверьте в интерфейсе в форме редактирования шаблона.

Igor, в ссылке пример использования только парсера из модуля, без остальной обвязки.

Чтобы в таймлайн добавилась запись, надо использовать пример "Полный цикл" из статьи https://dev.1c-bitrix.ru/api_d7/bitrix/documentgenerator/snippets.php

Igor, если вам для сделки надо несколько документов с одним номером, то есть два варианта. Оба потребуют наличие роботов / БП.

1. Создаем БП "Создание сопроводительных документов".
В БП первое активити - создание первого документа. В результате выполнения активити будет "Номер документа". Запишите этот номер в переменную.
После первого активити ставьте столько активити создания документов, сколько вам нужно, но в каждом активити указывается поле {DocumentNumber} из переменной.
Так у вас будет один номер во всех документах, созданных в рамках этого БП

2. Если у вас роботы. Аналогично первый робот создает первый документ, а номер пишете не в переменную, а в поле сделки.
В последующих роботах заполняете поле {DocumentNumber} из поля сделки.

G_107336047755713010335, вы можете написать php-код, в котором воспроизведете активити "Создание документа CRM", только без интерфейса (данные можно из переменных получить).

Код будет примерно следующий:
- получаем ид шаблона, тип провайдера (лид / сделка) и ид лида / сделки из переменных
- получаем данные о товарах из этого лида / сделки
- формируем два новых ArrayDataProvider как нужно
- вызываем апи создания документа, где передаем нужные данные в setFields и setValues
- записываем нужные данные в переменные и можно их использовать дальше.

G_107336047755713010335, это будет непросто.

Вместо активити можно воспользоваться тем же событием onBeforeProcessDocument, суть та же. Главное под рукой иметь объект документа.

Вот тут можно посмотреть пример кода, где на событии меняется содержимое списка товаров https://pastebin.com/dKrqmQra.
Всё никак не дойдут руки оформить нормально в документацию.

Вам надо будет сделать следующее:
1. Достать данные о товарах из документа в отдельный массив
2. Распихать данные о товарах по двум отдельным ArrayDataProvider
3. Передать описание полей для ваших новых ArrayDataProvider
4. Очистить исходный PRODUCTS (хотя если для него нет полей в шаблоне, можно и не трогать).

Задача довольно сложная, я бы рекомендовал двигаться по шагам. Будут вопросы - кидайте код, посмотрю.

Иван Рыков, во-первых, надо пометить поле, что оно является файлом.

Для этого надо в описание поля с картинкой добавить тип
не забудьте свои коды правильно подставить.

Если это было сделано и вариант со ссылкой не прокатил, то попробуйте вставить абсолютный путь к файлу, либо id из b_file (только в виде строки).
Вот в этом методе \Bitrix\DocumentGenerator\Body\Docx::getImage() из значения получается путь к файлу, можете посмотреть.

Игорь Моргачёв, парсер вырезает все плейсхолдеры из любых атрибутов. Дело не в ссылках, это общий подход. Работает только в изображениях.

Вставляйте как текст, без гиперссылки на нём.

Игорь Моргачёв, я примерно понял, чего вы хотите.

Мне не удалось добиться такого поведения (ссылка на изображении) даже в редакторе (вставляю ссылку, сохраняю, открываю - ссылки нет). По крайней мере в libreoffice. Поэтому не смог проверить, как оно там храниться, чтобы подсказать.

В любом случае это вряд ли будет работать сейчас. Гиперссылки - это отдельные объекты, путь к которым хранится внутри атрибутов. А парсер сейчас перед обработкой вырезает все плейсхолдеры из атрибутов, кроме картинок (сделано специально, т.к. атрибуты гораздо чувствительней к вставляемым в них данным).


Боюсь, чтобы в таком виде с помощью генератора документов вам не получится решить задачу. Вставляется ссылку текстом рядом с изображением.

Феликс Ерм, для начала я бы посоветовал проверить, сможет ли генератор документов скопировать строку вложенной таблицы. Если честно, не проверял такой кейс. Может, и будет работать. Если не сможет - вам придётся переформатировать шаблон таким образом, чтобы коды и названия оквэд были в строке отдельной таблицы.

"Из коробки" документы в CRM поддерживают довольно ограниченный набор полей типа "список", которые можно вставлять в таблицу. Как один из вариантов с "особенностями", можно было бы создать отдельное направление сделок, назвать его "оквэды" и поскидывать в него ваши оквэды. А дальше в связанных сущностях сделать множественное поле привязки к сделкам, где указывать эти самые коды. Таким образом у вас направление будет что-то вроде универсального списка. В этом случае не придётся программировать, но есть куча других нюансов.


Правильнее было бы использовать универсальный список для хранения оквэдов. Проблема в том, что документы в CRM не умеют печатать данные из универсальных списков. Для печати данных оттуда придётся использовать rest.

Выглядеть это будет так: создаете множественное поле привязки к элементам инфоблоков. Указываете в сделке нужные оквэды. Создаете веб-хук или приложение, которое будет доставать данные из сделки и формировать на их основе данные для таблицы. Примеры есть тут https://dev.1c-bitrix.ru/rest_help/documentgenerator/example.php#generate_doc_array

К сожалению, пока нет возможности этим заняться. К марту постараюсь выпустить обновление. Уже не так важно устаканивание апи, уже и так сойдёт.

Евгений Хазиахметов, если вкратце, то CIBlockElement - старое апи. Оно всё ещё актуально и много где используется.


Но в 19 версии iblock вышло полноценное апи для таблиц элементов и их свойств через ORM.

https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&CHAPTER_ID=012864&LE...

Если вы пишете новый код, то предпочтительней использовать новое апи, учитывая особенности, изложенные в курсе.





Отдельные классы - это не костыли. С помощью ORM сейчас можно всё достать, но для этого может потребоваться чуть больше кода, чем раньше.

Попробуйте установить модуль documentgenerator. Есть баг по этому поводу (что без модуля валится), выйдет в следующем обновлении.

Не понял сразу, что речь про облако.

Событие onBeforeProcessDocument и другие из раздела "кастомизация" относятся только к коробке.


Рассмотрим пример на бесплатном тарифе.
Например, надо создавать договор об оказании услуг на каждую новую компанию определенного типа.
Принципы работы реста здесь не буду рассказывать, посмотрите курс / документацию.

В облаке оптимальный вариант будет следующий:

1. Создаете исходящий веб-хук на создание компании (https://dev.1c-bitrix.ru/rest_help/crm/company/events_company/on_Crm_Company_Add.php)
2. В этом веб-хуке анализируете тип компании, и если он нужный - генерируете qr-код на основе данных компании
3. Сохраняете qr-код у себя на сервере и запоминаете ссылку к нему
4. Дергаете веб-хук на генерацию документа, где в нужном поле передаете ссылку на картинку с qr-кодом (https://dev.1c-bitrix.ru/rest_help/crm/documentgenerator/documents/crm_documentgen­erator_document_ad..., пример https://dev.1c-bitrix.ru/rest_help/documentgenerator/example.php#generate_doc_with_image)

Теперь в таймлайне компании покажется созданный договор.

Дальше можете достать отдельно файл из документа, а сам документ удалить. Или отправить его по почте и т.д.


Аналогично действуем для других типов сущностей.

Это будет довольно сложно, особенно, если захочется сохранить возможность обновления.

С точки зрения документа, qr-код - это изображение. Понятно, что для каждого документа это будет уникальная картинка. Как вы его формируете, на основе чего - это уже ваше дело. Сделайте изображение через свой сервис, а в документ вставьте как картинку. Не надо усложнять.

С помощью события onBeforeProcessDocument вы можете получить объект документа, и оттуда вытащить все нужные для формирования qr-кода данные (в том числе название и номер). При желании их можно тут же переопределить.

Ну либо объясните, почему qr-код - это не просто изображение.

Насколько я понимаю, qr-code - это просто изображение.
Вам не нужен отдельный провайдер для этого.

Самый простой случай - каким-то образом загружать изображение в поле  сделки / лида (или откуда вы печатаете документ) и вставлять это  изображение как обычное поле в шаблон.

Вставьте в шаблон документа изображение, пропишите у него код (как указано в документации, или посмотрите в предустановленных шаблонах как вставлены печать и подпись) и всё будет работать само. Как вы загрузите изображение - это отдельная задача.

Если без отдельного поля в источнике, то укажите произвольный код ({QrCode}).
Дальше заполняйте его через рест или через робота / БП.

Если нужно php-апи, то алгоритм такой же, только значение поля надо передать через событие  onBeforeProcessDocument
https://dev.1c-bitrix.ru/api_d7/bitrix/documentgenerator/customization.php

К сожалению, это правда. От меня здесь ничего не зависит, ждём дальше.

Пока что никак. Ждем, когда модуль transformercontroller и обвязка к нему выйдет в составе виртуальной машины - после этого будет конвертироваться локально.

До тех пор придётся реализовывать конвертацию самостоятельно.

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

Если изображения и pdf - это сконвертированные документы, то можно их хранить недолго (неделю-две). А при просмотре конвертировать повторно.

В облаке так и работает. Сконвертированные версии хранятся в течение 30 дней, после чего удаляются. При повторном просмотре конвертируются ещё раз.


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

Хост для публичной ссылки формируется методом \Bitrix\Main\Engine\UrlManager::getHostUrl()

Скорее всего, у вас протокол стоит https, но работает на 80 порту.

Попробуйте http или настройке нормально работу https