Первичная установка

Найдите и установите приложение в Маркете Битрикс24 «Меню Документов». При установке предоставьте все запрашиваемые разрешения. После установки и открытия приложения у вас появится красная надпись "Внимание!! На данной вкладке доступен только просмотр и редактирование..." - это нормально. Доступ к приложению появится в левом меню CRM, а так же из карточки сделки. При входе в приложение из главного меню CRM будет доступ только к просмотру и редактированию документов, для того чтобы создать документ, нужно зайти в необходимую сделку и в ней выбрать документ для создания.

Общие сведения по настройке редактора документов

Для редактирования приложения, необходимо перейти в приложение из главного меню или сделки с правами администратора на портале. Если вы вошли с правами администратора, появится красная кнопка «Настройки». При нажатии на которую у вас откроется меню настройки ваших документов.

1. Для начала нажмите на зелёную кнопку «Обновить» снизу экрана, для отображения ваших данных. Если «object» станет равен не нулю, то вы всё сделали правильно.

2. При нажатии на «Добавить» будет создан новый объект, у которого можно будет выбрать название и содержимое. Для изменения типа объекта нужно слева от объекта нажать на прямоугольник и в разделе Type выбрать нужный тип данных. Для изменения позиции перетягивайте объект, держа его за кнопку с шестью квадратами.

3. Для сохранения данных нажмите «Сохранить», после чего данные будут сохранены, но для их отображения необходимо обновить страницу.

4. Если вы создали лишний объект, то нажать на прямоугольник слева от объекта и выбрать пункт «Remove».

Создание документов

Для создания документа откройте раздел «Создание документов», перейдите в нужное меню и раскройте требующийся подраздел, после этого нажмите на кнопку с наименованием документа. Если кнопка ведёт на генератор документов - будет создан документ, с указанными в нём данными из карточек CRM. Если же кнопка ведёт на бизнес-процесс, тогда будет запущен БП с вашими расчётами и переменными в шаблоне. Время создания простого документа в среднем от 1 до 10, создание через БП зависит от процессов в нём и множества полей, которое вы указали в создаваемом шаблоне, для крупных БП время создания документа может достигать 1-2 минут.

Пункт меню

Для добавления пункта меню, необходимо нажать на кнопку «Добавить», после чего нажать на прямоугольник слева от объекта и в разделе «Type» выбрать пункт «Object». Далее неоходимо развернуть объект «sections», после чего зажать кнопку с шестью квадратиками и перетянуть созданный объект вниз раздела «sections», после чего название нового объекта сменится на порядковый номер.

Далее можно приступить к редактированию содержимого. Для наглядности можно развернуть раздел с предыдущим порядковым номером. Для «(empty object)» выберите в контекстном меню «Append», затем укажите название «id» и значение для него следующего id от того, что находится в предыдущем разделе. Теперь нажимаем меню нашего раздела и выбираем «Append», после чего повторяем предыдущие действия, но в название указываем «title» и здесь пишем название, которое будет отображаться в качестве раздела. Такую же процедуру проводим для «color», а в значение устанавливаем желаемый цвет, так же можно указать чёрный цвет текста если добавить «text-dark» к цвету, на выбор доступны следующие значения:

• primary - синий
• secondary - серый
• success - зелёный
• danger - красный
• warning text-dark - жёлтый
• info text-dark - голубой
• light text-dark - белый
• dark - чёрный

Раздел

Для создания раздела документов, в массив «items» добавляем объект типа «Object» двумя значениями:

• title - Наименование раздела
• docs - с типом «array»

Документ

Документы можно добавить как с созданием напрямую из простого генератора Битрикс24, так и с созданием через Бизнес-процесс, чтобы провести перед созданием необходимые расчёты и заполнения переменных. Для добавления документа, в раздел «docs» добавляем объект типа «Object» тремя значениями:

• title - Наименование раздела
• doctype - здесь можно указать только 2 значения на выбор, «doc» или «bp»
• numtype - в данном параметре нужно указать id шаблона документа или БП, который нужно создать/активировать. Примеры ниже

Примеры шаблонов документов и Бизнес-процессов

Шаблоны документов и Бизнес-процессы создаются Вашими силами, приложение только запускает их.

Для создания шаблонов документов используйте стандартные переменные, доступные в любой сделке - "ДОКУМЕНТ" - "Добавить новый шаблон" - "⚙️" - "Список полей". Советы:

• Для вывода в табличную часть документа сущностей смарт-процессов создайте поле с типом "Привязка к элементам CRM" и внесите в него все необходимые вам сущности, далее в списке переменных выберите за основу поле связи - у вас появятся поля относящиеся к этому СП. Эти переменные укажите в таблице шаблона.
• Инструкция от Битрикса по созданию шаблонов документов - перейти

Для создания Бизнес-процессов перейдите в раздел "CRM" - "Настройки" - "Настройки CRM" - "Роботы и бизнес-процессы" - "Бизнес-процессы" - в блоке "Сделка" нажмите "Добавить шаблон". Советы:

• Для создания БП используйте все стандартные блоки, дополнительных действий нет. Выполняйте любые расчёты, которые вам необходимы, единственное, для создания документа через БП, в самом его конце поставьте блок действия "Создать документ" и укажите в нём шаблон документа, который нужно создать, а также переменные, если они необходимы.
• Если у вас большой шаблон документа, в котором множество данных выводится из связей со смарт-процессами (СП) - разделите документ на 2 части или более (поставьте в конце БП не один блок создания документа, а 2 и более), т.к. в Битриксе есть ограничение на создание документов в 1 минуту, если документ будет создаваться дольше - документ не будет создан, это ограничение самого Битрикса.
• Инструкция от Битрикса по созданию Бизнес-процессов - перейти

Примеры где брать id шаблона документа и бизнес-процесса для параметра numtype

ID шаблона документа в разделе «Список шаблонов» при отображение данного параметра в списке или при открытии шаблона и просмотра адресной строки. Для БП ID отображается в адресной строке. Скриншоты ниже.

Видео-инструкция

Контакты

При возникновении проблем или вопросов с приложением, можете связаться с нами

• Телеграм разработчика
• Наша почта - yuriteh_tg@mail.ru