Разные виды документации

• Онлайн документация для пользователей - описание интерфейса системы управления сайтом, ее основных модулей и наиболее типичных операций. Также в ней содержится полное описание прикладного программного интерфейса.
• Онлайн документация для разработчиков по старому ядру, по ядру D7 и по Rest_API. Предназначена для технических специалистов со знанием PHP и HTML. В ней содержатся сведения о технологиях и основных принципах, заложенных в систему, описание классов и функций по всем продуктам.

Учебные курсы

Онлайн Курсы - это методические пособия по работе с продуктом, которые включают в себя описание и примеры работы с системой.

Для изучения учебных материалов в оффлайне на индексной странице каждого курса размещаются [dw]ссылки на файлы[/dw][di][/di] формата Epub.

Контекстная справка

Контекстная справка выводит в Административной части системы информацию, относящуюся к открытому в данный момент разделу или странице. Доступна как в [ds]1С-Битрикс: Управление сайтом[/ds][di]Обилие справочной информации «1С-Битрикс: Управление сайтом» иной раз создаёт проблему: где искать ответ на свой вопрос? Для облегчения поиска иголки в стоге сена создана Контекстная помощь, доступная только в Административном разделе системы.

Подробнее ...[/di], так и в [ds]Битрикс24 в коробке[/ds][di]Для обучения работе в сервисе Битрикс24 создана специальная служба Поддержки24. К ней можно обратиться нажатием на кнопку со знаком вопроса в "шапке" сервиса...

Подробнее ...[/di].

Мастер магазина

FAQ - Частые вопросы

Частые вопросы - подборка решений наиболее часто встречающихся проблем при работе с продуктом в удобном представлении.

Всплывающие подсказки

Используются в тексте в следующих случаях:

• пояснить какой-то термин;
• дать наглядное представление о команде интерфейса;
• дать дополнительную, но не относящуюся напрямую к выполняемым работам, информацию;
• показать описание и ссылку на страницу компонента в пользовательской документации.

Всплывающие подсказки обозначаются пунктирным подчёркиванием: [dw]пример подсказки[/dw][di]В окне отображается подробное содержимое подсказки. Подсказка может состоять из текста и/или изображения.[/di].

Табы (вкладки)

Текст каждого урока разбит на табы. Другими словами их можно назвать тематическими вкладками. Это сделано с целью избавить читателя от прокрутки экрана и быстро перейти к нужной части урока. Если вам неудобно пользоваться вкладками, то [dw]отключите их[/dw][di][/di], тогда весь урок будет выводиться в виде единого длинного текста.

Спойлеры, скрывающие текст

В спойлерах размещается информация, которая имеет вторичное значение, но может быть полезна «для общего развития». Для открытия спойлера кликните на «+» в спойлере:

Чтобы избежать лишней прокрутки экрана, в спойлерах может быть размещена большая по объёму информация.

Выделение абзаца фоном

Форматирование целых абзацев текста используется для выделения какой-либо информации с целью указать её направленность:

• Определения каких-либо сущностей, явлений, терминов и так далее выводятся в абзацах такого вида:
  Курс – организованная и логически завершенная последовательность страниц, содержащих информацию о некоторой предметной области.

• В Примечании размещается информация, поясняющая текст на странице, на которую стоит обратить внимание. Это могут быть примеры, расширенное объяснение, уточнение, ссылка на дополнительную информацию. Например:
  Примечание: подробное описание формы создания и редактирования теста представлено в документации по продукту.

• Предупреждения – это информация, имеющая критическое значение для работы того или иного функционала продукта. Например:
  Важно! Если курс был деактивирован, то результаты тестов и сертификаты по этому курсу будут недоступны пользователям. Если курс был удален, то результаты тестов и сертификаты этого курса будут также удалены.

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

Форматирование текста

Виртуальная машина

Виртуальная машина позволяет установить локальную демоверсию продукта «Битрикс24» на срок до 30 дней. Потом машину можно удалить и поставить заново на очередные 30 дней, потеряв при этом, правда, свои наработки на старой машине.

Следуйте нашей инструкции и вы успешно установите локальную версию. Шаги несложные и сопровождаются наглядными иллюстрациями-всплывашками:

1. Скачайте [dw]VMware Player[/dw][di]VMware Player – программный продукт, позволяющий запускать несколько операционных систем одновременно на одном компьютере.
   
   Помимо VMware Player, вы можете использовать VM VirtualBox для настройки виртуальной машины.[/di] и установите его. Эта программа нужна нам для запуска виртуальной машины с демонстрационным порталом. Установка её несложна, просто следуйте шагам мастера установки (для учебных целей укажите бесплатную версию для [dw]НЕкоммерческого использования[/dw][di][/di]).
2. На странице со списком виртуальных машин скачайте [dw]дистрибутив[/dw][di][/di] нашей, уже настроенной, виртуальной машины BitrixVM.
3. Загруженный архив [dw]распакуйте[/dw][di]Такие файлы Вы увидите в папке после распаковки архива:
   
   [/di] в любую, удобную вам, папку. (Например, в папку на диске С: С:\BitrixVM\).
4. Запустите программу VMware Player и добавьте виртуальную машину BitrixVM, нажав [dw]Open a virtual machine[/dw][di][/di] и выбрав единственный доступный [dw]файл[/dw][di][/di] из папки, в которую был распакован архив.
5. Запустите виртуальную машину с помощью кнопки [dw]Power on[/dw][di][/di]. По окончании загрузки операционной системы отобразится общая информация. Для вас важен IP-адрес, который присваивается автоматически и выводится в поле [dw]bitrix url[/dw][di][/di] (пример адреса: 192.168.1.36). Запомните его.
6. В адресной строке вашего любимого браузера (Chrome, Firefox или любой другой) введите этот адрес. Откроется [dw]окно установки[/dw][di][/di]. Нажмите кнопку Установить.
7. Выберите [dw]демонстрационную версию[/dw][di][/di] дистрибутива продукта «1С-Битрикс24». Для обучения на наших курсах в большинстве случаев вам подойдет «1С-Битрикс24» в редакции Корпоративный портал. Если по какой-либо причине вас интересует другая редакция, можете выбрать её.
8. Начнется [dw]загрузка дистрибутива[/dw][di][/di]. Дождитесь её окончания и появится мастер установки решения.
9. Следуйте шагам мастера. Тут нет ничего сложного, только настройки вашего «Битрикс24» (например, логин и пароль администратора, дизайн портала, название компании). Если нужно, то более подробное описание каждого шага мастера есть в уроке: Мастер настройки портала .

Установка завершена! Теперь у Вас есть 30 дней на использование демоверсии.

Начинайте обучение работе с коробочной версией «Битрикс24». Не забудьте, что для работы с порталом в таком варианте вам всегда нужно сначала запускать VMware Player и виртуальную машину (п. 5 инструкции), и только потом открывать портал по его IP-адресу.

Возможные проблемы и их решение

Информацию об ошибках и способы их решения при установке демоверсии в BitrixVM смотрите в соответствующем уроке учебного курса Виртуальная машина BitrixVM.

  Скрипт BitrixSetup

Скрипт BitrixSetup позволяет устанавливать продукты компании «1С-Битрикс» на хостинг. У многих хостинг-провайдеров имеется бесплатный тестовый период, что удобно для обучения и практики.

В видео ниже продемонстрирован пример установки на хостинг демоверсии «1С-Битрикс: Управление сайтом». Чтобы установить пробную коробочную версию «Битрикс24», то следуйте видеоинструкции, но на этапе запуска мастера установки (тайминг на видео 5:12) выберите дистрибутив «1С-Битрикс24» и далее придерживайтесь указаний мастера.

   Как узнать, какая редакция сейчас у вас?

Так как у разных компаний могут быть разные потребности в функционале, 1С-Битрикс предоставляет целую линейку редакций (лицензий), отличающихся по набору доступных инструментов.

Чтобы узнать, какая редакция 1С-Битрикс установлена у вас, достаточно перейти [ds]в административном разделе[/ds][di] Административный раздел – часть сайта, где производится
управление модулями системы, структурой сайта, его содержанием, посетителями и
другими составляющими сайта. Недоступен для просмотра обычным посетителям сайта.

Для перехода в Административный раздел служит закладка Администрирование,
расположенная на Панели управления в Публичном разделе сайта.

Подробнее...[/di] сайта на страницу Обновление платформы (Marketplace > Обновление платформы) во вкладку [dw]Установка обновлений[/dw][di] [/di]:

   Информация о редакциях в уроках

Для вашего удобства мы указываем в уроках ограничения по редакциям (т.е. в каких редакциях недоступен описываемый в уроке функционал):

  Как узнать текущую версию продукта?

Когда в уроках упоминается «версия продукта» (без указания конкретного модуля), то имеется в виду версия Главного модуля.

Версию продукта (т.е. версию Главного модуля) можно определить несколькими способами:

• прокрутив в административной панели любую страницу до конца:

  

• на странице Модули (Настройки > Настройки продукта > Модули):

  

  Примечание. На этой странице можно посмотреть текущие версии всех модулей, установленных в системе.

• с помощью предустановленного [ds]гаджета на Рабочем столе[/ds][di] Гаджеты в продуктах «1С-Битрикс: Управление сайтом» – это особые программные элементы, выполняющие функции уведомления и быстрого перехода к различным элементам управления и настройки системы и её элементов. С помощью гаджетов на Рабочем столе может быть представлена самая разнообразная информация.
  
  Подробнее...[/di]:

  

  Сравнение редакций «1С-Битрикс: Управление сайтом»

Ниже сравниваются возможности всех редакций продукта [ds]«1С-Битрикс: Управление сайтом»[/ds][di] «1С-Битрикс: Управление сайтом» – профессиональная система управления сайтами и интернет-магазинами.

Подробнее... [/di] по следующим категориям: CMS, Интернет-магазин, Маркетинг, Производительность, Безопасность и мобильность. Для просмотра таблицы сравнения кликните по значку справа от названия выбранной категории.

  Описание

Необходимо понимать, что БП – это программирование, но в большинстве случаев без написания кода. Говорить, что любой менеджер справится с созданием БП – это некоторое преувеличение. Требуется постановка задачи, алгоритмирование, тестирование – для этого нужны определенные навыки и базовая подготовка.

В системе все бизнес-процессы работают с документами (таким документом может быть файл, элемент инфоблока, элемент CRM) и их версиями. Для каждого документа (из инфоблока, списков или др.) существуют свои шаблоны бизнес-процессов. Поддерживаемые типы документов:

• Элементы инфоблоков в административной части
• Элементы универсального списка
• Файлы из библиотеки документов («Битрикс24 в коробке»)
• Элементы CRM («Битрикс24 в коробке»): Лид, Контакт, Компания, Сделка, Коммерческое предложение, Счета, Смарт-процессы;
• "Виртуальный документ" (для бизнес-процессов организаций, реализуемых с помощью компонента [comp include_bizproc_wizards]Бизнес-процесс (комплексный компонент)[/comp] в публичной части сайта)

В продуктах компании 1С-Битрикс бизнес-процессы можно найти в следующих местах:

• Инфоблоки в административной части сайта («1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке»)
• Универсальные списки («Битрикс24 в коробке», Сервисы > Списки )
• Процессы в ленте новостей («Битрикс24 в коробке», Автоматизация > Бизнес-процессы > Процессы в ленте новостей )
• Битрикс24.Диск («Битрикс24 в коробке», Автоматизация > Бизнес-процессы > Процессы в Общем диске или Диск > Общий диск )
• CRM («Битрикс24 в коробке», Автоматизация > Бизнес-процессы > Процессы в CRM или CRM > Настройки > Настройки CRM > Роботы и бизнес-процессы ).

  Права на бизнес-процесс

В большинстве случаев для корректной работы модуля Бизнес-процессы необходимо произвести настройки прав доступа для пользователей и настройки инфоблоков.

При создании бизнес-процесса при выборе пользователей в настройках действий в форме [dwi include_bp_insert_value_form]Вставка значения[/dwi] выводятся только те пользователи, которые имеют соответствующий уровень доступа к типу документа, для которых создаётся бизнес-процесс.

Например, если в настройках информационного блока для определённой группы пользователей будет выставлен уровень прав Чтение, то они не будут иметь доступа к работе с бизнес-процессами инфоблока, хотя могут просматривать его элементы.

  Видеоматериалы

Рекомендуем посмотреть видеозаписи с [ds]вебинаров по Битрикс24[/ds][di]По ссылке вы найдете как активные, так и прошедшие вебинары. Для просмотра прошедших вебинаров
выберите Тему и нажмите Показать ещё:

[/di], в которых рассказывается о том, что такое бизнес-процессы, как с ними работать, а также рассмотрены примеры их использования. По указанной ссылке доступен список вебинаров начиная с 2015 года по настоящее время.

Так же будет полезно изучить курс Автоматизация бизнес-процессов.

Вебинар Роботы и бизнес-процессы. RPA с точки зрения разработчика. Техноволна 1 от 06 апреля 2020.

  Документация по теме

• Пользовательская документация по модулю "Бизнес-процессы"
• Модуль Бизнес-процессов (блог)

  Бизнес-процесс со статусами

Бизнес-процесс со статусами представляет собой набор состояний, переходов и действий. Одно из состояний обязательно обозначается как начальное состояние. Далее, по мере выполнения, процесс переходит из одного состояния в другое. Переходы выполняются на основе событий.

Посмотрим на [dw]пример[/dw][di]Пример создания этого бизнес-процесса рассматриваем в отдельном уроке.[/di] такого шаблона:

На скриншоте видим бизнес-процесс с тремя связанными статусами: Рассмотрение документа, Доработка и Утвержден.

  Общая логика работы

Посмотрим общую логику работы бизнес-процессов со статусами.

Для каждого статуса могут быть настроены 4 действия. А для каждого действия доступно создание [dwi include_bp_sequential]последовательного[/dwi] подпроцесса.

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

Обязательно должна быть предусмотрена смена статуса. У действия статуса Команда есть специальный параметр, осуществляющий такую смену. Или уже среди действий последовательных подпроцессов удобно использовать действие [dwi include_bp_set_status]Установить статус[/dwi]. Если смена статуса не определена каким-либо способом, то текущий статус считается конечным и бизнес-процесс завершается.

Если для статуса определен последовательный подпроцесс для финализации этого статуса (обработчик выхода из статуса), то он автоматически выполняется непосредственно перед выходом из данного статуса (перед переходом в другой статус).

  Документация по теме

• Создание шаблона бизнес-процесса со статусами
• Пример использования бизнес-процесса со статусами для организации обработки и доработки документа

  Описание

Типовые бизнес-процессы включены в состав младших редакций как неизменяемые процессы. Они настраиваются на работу с нужными сотрудниками, но схема прохождения документа остается неизменной. Изменение шаблонов типовых бизнес-процессов, а также создание собственных шаблонов возможно только при наличии модуля [dw]Дизайнер бизнес-процессов[/dw][di]Модуль Дизайнер бизнес-процессов, входящий в старшие редакции продуктов "1С-Битрикс", предназначен для проектирования, создания и изменения бизнес-процессов.
Подробнее...[/di], который доступен только [dw]в старших редакциях[/dw][di]Подробнее о наличии модулей в зависимости от редакций можно посмотреть на страницах Редакции продукта для «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке».[/di].

  Типовые бизнес-процессы для документов

  Типовые бизнес-процессы организации

[dw]Бизнес-процессы организации[/dw][di]Подробнее в уроке Бизнес процессы организации.[/di] предназначены для автоматизации деятельности организации. По умолчанию в Битрикс24 представлено пять типовых бизнес-процессов:

1. Выдача наличных
2. Исходящие документы
3. Счет на оплату
4. Заявление на отпуск
5. Заявление на командировку

В облачной Битрикс24 Администратор изменяет и копирует эти бизнес-процессы. А на тарифах «Профессиональный» и «Энтерпрайз», а также в «коробочной Битрикс24», может создавать собственные.

  Действия по созданию шаблонов

• Универсальные списки (публичная часть сайта)
  • перейти к желаемому списку на соответствующей странице Списки (Сервисы > Списки);
  • перейти к списку шаблонов бизнес-процессов с помощью кнопки [dw]Бизнес-процессы[/dw][di][/di], расположенной на странице просмотра списка;
  • воспользоваться соответствующей [dw]ссылкой[/dw][di][/di] для создания шаблонов бизнес-процессов.


• Общий диск
  • перейти на страницу Общий диск (Диск > Общий диск);
  • перейти к списку шаблонов бизнес-процессов с помощью пункта [dw]Бизнес процессы[/dw][di][/di] в меню настроек;
    Примечание: Если в меню настроек нет пункта Бизнес-процессы, то нужно [dw]включить поддержку[/dw][di]Примечание: Для персональных документов в разделе Мой диск бизнес-процессы включить нельзя.[/di] бизнес-процессов для библиотеки, выбрав в том же меню настроек пункт Настройка бизнес-процессов, и в открывшейся форме включив опцию [dw]Активировать бизнес-процессы[/dw][di][/di].
  • воспользоваться соответствующей ссылкой для создания шаблонов.


• Инфоблоки (административная часть сайта)
  • перейти на страницу редактирования инфоблока (Контент > Инфоблоки > Типы инфоблоков > [требуемый_инфоблок]);
  • включить поддержку бизнес-процессов, установив для опции Участвует в документообороте или бизнес-процессах значение [dw]бизнес-процессы[/dw][di] [/di];
  • на закладке Шаблоны бизнес-процессов [dw]отобразятся[/dw][di][/di] типовые шаблоны.
  Примечание: Перейти к списку шаблонов возможно непосредственно из самого инфоблока с помощью кнопки [dw]Шаблоны бизнес-процессов[/dw][di][/di] (если данный инфоблок участвует в бизнес-процессах).


• Бизнес процессы организаций (публичная часть сайта, «Битрикс24 в коробке»)

  Типовые шаблоны устанавливаются автоматически с установкой модуля Бизнес-процессы.

  Удаление шаблонов типовых бизнес-процессов

Для удаления шаблона используйте пункт меню действий Удалить.

  Настройка автозапуска для БП документов

Настройка выполняется на странице Бизнес-процессы (меню настроек в разделе Диск > Общий диск):

• открываем [dw]список[/dw][di][/di] бизнес-процессов;
• на странице Шаблоны бизнес-процессов в меню действий выбираем способ [dw]автоматического запуска[/dw][di][/di] – Запускать при создании или Запускать при изменении;
• статус запуска бизнес-процесса отобразится в колонке [dw]Автозапуск[/dw][di][/di].
  Примечание: Например, установим автоматический запуск бизнес-процесса Утверждение документа со статусами при создании и тогда сотрудник, загружая файл в данный раздел документов, должен [dw]указать[/dw][di][/di] все необходимые параметры запуска бизнес-процесса.

  Запуск БП вручную

Чтобы запустить вручную бизнес-процесс для некоторого документа:

• В меню действий документа выберите пункт Бизнес-процессы, а затем в предложенном списке [dw]найдите[/dw][di][/di] необходимый бизнес-процесс (например, Ознакомление с документом);
• Укажите необходимые параметры запуска и нажмите кнопку [dw]Запустить[/dw][di][/di].

Бизнес-процесс запустится и начнет выполняться в соответствии со своим шаблоном и произведенными настройками.

  БП сотрудника

Каждому сотруднику отображается список запущенных им бизнес-процессов с помощью анимированных иконок в колонке Название после названия файла в списке документов. Если вы участвуете в бизнес-процессе, то рядом с анимированной иконкой увидите [dw]восклицательный знак[/dw][di][/di].

Выполнение назначенных заданий по бизнес-процессу осуществляется на закладке [dw]Бизнес-процессы[/dw][di][/di] личной страницы.

  Описание

Бизнес-процессы организации предназначены для автоматизации деятельности организации. По умолчанию создано и представлено [dw]пять[/dw][di][/di] типовых [dw]бизнес-процессов[/dw][di]Важно! Если вы не можете работать с БП организации на портале, обратитесь к Администратору портала.[/di]:

1. Выдача наличных
2. Исходящие документы
3. Счет на оплату
4. Заявление на отпуск
5. Заявление на командировку

В облаке Администратору доступно изменение и копирование бизнес-процессов. А в тарифе Профессиональный облачного Битрикс24 – [dw]создание собственных[/dw][di]Создание нового бизнес-процесса организации, а также редактирование и настройка уже существующих доступно только при наличии необходимой квалификации и соответствующих прав доступа (по умолчанию – только для Администратора).[/di].

Работа с БП осуществляется через пункт меню Бизнес-процессы:

  Задания БП

Как только появятся бизнес-процессы, требующие внимания, их количество будет отражено рядом с пунктом меню Бизнес-процессы. Выполнение назначенных заданий осуществляется на закладке Задания бизнес-процессов (Бизнес-процессы > Задания бизнес-процессов). На закладке видим информацию, вывод которой настраивается, если щелкнуть правой кнопкой мыши по шапке таблицы. Также приведено [dw]описание действий[/dw][di][/di], которые необходимо сделать.

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

• Выберите [dw]соответствующую команду[/dw][di][/di] в меню действий.
• Кликните правой кнопкой мыши [dw]по строке действия[/dw][di][/di] и выберите Подробнее.
• Дважды кликните левой кнопкой мыши по строке действия.

Воспользуйтесь [dw]фильтром[/dw][di] [/di] для поиска необходимых бизнес-процессов в списке. Руководитель подразделения сможет найти БП, выполняемые его подчиненными, и делегировать их.

  Процессы в ленте Новостей

На странице [dw]Процессы в ленте[/dw][di]Для старых версий коробочного Битрикс24 список располагается во вкладке Сервисы > Процессы.[/di] (Бизнес-процессы > Процессы в ленте) пользователь просматривает и запускает бизнес-процессы, к которым у него есть доступ. Также в этом разделе администратор указывает, какие из них доступны для вызова прямо из [dw]ленты Новостей[/dw][di] Важно! В ленте Новостей для вас отображаются только те процессы, для которых у вашей группы пользователей есть необходимые права доступа. Если вам не доступна работа с БП организации на портале, обратитесь к Администратору портала.[/di].

  Мои процессы

Вызов бизнес-процессов на исполнение возможен и через закладку Бизнес-процессы > Мои процессы. Эта страница хранит все БП, которые вызывались вами, включая историю их исполнения и полную информацию о них.

После нажатия на кнопку [dw]Запустить процесс[/dw][di] [/di] предлагается заполнить поля с входными параметрами. Однако настройки параметров работы (Кто утверждает, Кто оплачивает и т.п.) должны быть предварительно проведены, иначе бизнес-процесс [dw]не начнет[/dw][di][/di] свое выполнение.

  Все активные

На странице Все активные (Бизнес-процессы > Все активные) отображен список активных запущенных БП. На этой странице отслеживаем выполнение запущенных БП, контролируем зависшие. Обычный пользователь видит только те, которые запущены им самим. Администратору портала видны все процессы, запущенные на портале, которые он удалит в случае зависания.

1 выберите модули, для которых были запущены БП. Также доступен выбор зависших процессов.

2 используйте фильтр для поиска определенных задач.

3 настройте отображение колонок списка, кликнув правой кнопкой по шапке таблицы.

4 с помощью меню действий перейдите к документу (для администратора доступно удаление).

  Административная часть сайта

Информация об административной части актуальна только для продуктов «1С-Битрикс: управление сайтом» и коробочной версии «Битрикс24».

Журнал выполнения бизнес-процесса для элементов информационного блока находится в административной части сайта / портала.

Для просмотра журнала перейдем в режим редактирования элемента инфоблока (документа, для которого запущен бизнес-процесс) на вкладку Бизнес-процессы и затем используем ссылку в поле Текущий статус. Откроется форма с [dw]Историей выполнения бизнес-процесса[/dw][di][/di].

Для просмотра более подробной информации используем ссылку Расширенный режим:

  Публичная часть сайта

Просмотр журнала в публичной части отличается в зависимости от типа документа. Для просмотра описания как найти журнал, откройте спойлер для нужного типа документа.

Вид лога одинаков для всех типов документов и представлен в виде таблицы:

По нажатию правой кнопкой мыши по шапке таблицы лога откроется [dw]меню[/dw][di][/di], в котором настраивается лог, в том числе, выбираются колонки, которые в нем отобразятся.

  Настройка инфоблоков

Чтобы документы и файлы определенного инфоблока работали в режиме Бизнес-процессов необходимо произвести настройки этого инфоблока в административном разделе. Это может сделать администратор системы либо пользователи с правами доступа к модулю Бизнес-процессы не ниже Полного доступа.

• Для настройки информационного блока перейдите на страницу настройки свойств инфоблока (Контент > Информ. блоки > Типы информ. блоков > [Нужный_тип_инфоблока] > [Нужный_инфоблок] ).
• На вкладке Инфоблок в поле Участвует в документообороте или бизнес-процессах выберите Бизнес-процессы.



• Нажмите кнопку Применить для внесения изменений.

Теперь выбранный инфоблок будет участвовать в Бизнес-процессах.

  Настройка прав доступа

Для работы с бизнес-процессами к модулю должен быть подключен не только инфоблок. Необходимо дать нужные права для групп пользователей.

• Перейдите на вкладку Доступ настраиваемого инфоблока и назначьте для соответствующих групп уровень доступа не ниже Бизнес-процессы.



Уровень доступа Бизнес-процессы отобразится в списках, только если включено участие инфоблока в бизнес-процессах.

Внимание! Уровень доступа Бизнес-процессы позволяет указанным группам пользователей только лишь участвовать в бизнес-процессах. Чтобы пользователи смогли сами запускать БП, необходимо выставить более высокий уровень прав доступа для инфоблока, например Изменение.
• Нажмите кнопку Применить для внесения изменений.

  Настройка инфоблоков

Для участия инфоблока в Бизнес-процессах:

• Перейдем на страницу настройки свойств инфоблока (Контент > Инфоблоки > Типы инфоблоков > [Нужный_тип_инфоблока]) в административном разделе.
• На вкладке Инфоблок в поле Участвует в документообороте или бизнес-процессах выбираем Бизнес-процессы:

  

  Если в системе не установлен модуль Документооборот, то поддержка бизнес-процессов включается с помощью опции Участвует в бизнес-процессах.

  Настройка прав доступа

Для работы с бизнес-процессами необходимо дать права для групп пользователей. Перейдем на вкладку Доступ настраиваемого инфоблока и назначим для соответствующих групп уровень доступа не ниже Бизнес-процессы:

  Настройка автозапуска

Модуль Бизнес-процессы позволяет [dw]автоматически запускать[/dw][di]Примечание: Автоматический запуск БП рекомендуется для часто повторяющихся бизнес-процессов, для которых не требуется смена настроек.[/di] выбранные БП при создании/изменении элемента инфоблока. Есть два варианта включения автозапуска:

• В форме настроек информационного блока:
  • Перейдем на вкладку Шаблоны бизнес-процессов настраиваемого инфоблока.
  • В строке с названием нужного бизнес-процесса установим флаг в поле Автозапуск: Создание и/или [dw]Изменение[/dw][di]Внимание! Не используйте режим Изменение для БП, которые могут вызывать сами себя. Это приведет к цикличности.[/di]. Если оба флажка сняты, запуск БП возможен только вручную.
  Примечание: Если у вас установлена старшая редакция продукта (с модулем Дизайнер бизнес-процессов), то вы имеете возможность редактировать шаблоны типовых БП и создавать собственные, поэтому вам названия шаблонов типовых БП отображаются в виде ссылок и доступна ссылка Список шаблонов бизнес-процессов.

• В настройках шаблона бизнес-процесса.

Для запуска бизнес-процесса вручную используйте пункт меню действий [dw]Запустить бизнес-процесс[/dw][di][/di] желаемого элемента инфоблока.

  Настройка формы создания/изменения элемента инфоблока

При создании/изменении элемента инфоблока пользователь указывает не только название и другие параметры, относящиеся к контенту, но и все параметры запускаемого бизнес-процесса. Для этого настроим саму форму редактирования элемента инфоблока. Перейдем на страницу со списком элементов инфоблока, а затем к форме редактирования некоторого элемента. По умолчанию вкладка Бизнес-процессы, на которой производится управление бизнес-процессами, отключена. Для её включения есть [dw]два способа[/dw][di][/di]:

1. Выбираем команду Отменить настройки формы и все доступные вкладки появятся перед вами. Этот способ не удобен тем, что из всего, что появится, требуется только одна вкладка, остальные мешаются;
2. Выберите команду Настройки. Откроется окно Настройка формы редактирования. В секции Доступные вкладки выберите Бизнес-процессы и нажмите кнопку , чтобы в форме создания/редактирования элемента была доступна вкладка Бизнес-процессы с соответствующими полями.

Теперь, например, в форме добавления новости в публичной части сайта будет доступна вкладка [dw]Бизнес-процессы[/dw][di][/di].

  Бизнес-процессы (БП) универсальных списков

Работать с бизнес-процессами Универсальных списков можно на странице Сервисы > Списки > [Выбранный_список] при просмотре элементов списка. В меню элемента есть возможность запустить БП по шаблону или обработать уже запущенный БП. Например, остановить выполнение БП:

  БП в ленте Новостей

Есть возможность добавлять в список Бизнес-процессов в ленте Новостей собственные бизнес-процессы (БП). Чтобы в общем списке появился ваш бизнес-процесс, нужно:

Первый вариант

Вызвать форму создания бизнес-процесса через кнопку Создать новый на странице Автоматизация > Бизнес-процессы > Процессы в ленте новостей :

Либо воспользоваться командой Создать новый процесс в списке бизнес-процессов в ленте Новостей. Последний способ – рекомендуемый нами для использования:

Второй вариант

1. Создать и настроить новый Универсальный список:

   

2. Создать необходимый бизнес-процесс в списке:

   

3. Если бизнес-процесс создавался со страницы Сервисы > Списки, то в настройках параметров созданного списка по команде [dw]Перенести в процессы[/dw][di][/di] добавьте его в список процессов ленты Новостей. Кнопка видна только администратору.

   Включить отображение БП в списке Новостей можно воспользовавшись флажком Показать в Новостях на странице Бизнес-процессы > Процессы в ленте:

   

   После чего бизнес-процесс появится в списке Новостей.

  Особенности БП в ленте Новостей

В список процессов в ленте Новостей попадают только те, у которых стоит автоматический запуск При добавлении. Если шаблон настроен на ручной запуск или на запуск При изменении, то он не будет запускаться из ленты Новостей, а только из списка элементов:

Если в Универсальном списке несколько бизнес-процессов с настройкой автоматического запуска При добавлении, то в списке бизнес-процессов ленты Новостей отображается тот, который создан позже. Например, надо создать список с двумя БП: по одному происходит уведомление какого-либо лица о запуске БП, а по другому БП должны начать выполняться какие-то действия. В этом случае надо сначала создать бизнес-процесс на уведомление, а только потом – БП на действия.

  Настройки бизнес-процессов

Переход к [ds]шаблонам[/ds][di]Шаблон бизнес-процесса представляет собой последовательность шагов (действий) от начального к конечному, которые будут выполняться один за другим. Необходимо таким образом и в таком порядке составить шаги (действия), чтобы реализовать нужный алгоритм и получить необходимый результат.

Подробнее...[/di] бизнес-процессов в CRM выполняется по пути Автоматизация > Бизнес-процессы > Процессы в CRM или через раздел CRM CRM > Настройки > Роботы и бизнес-процессы > Бизнес-процессы:

В любом варианте откроется страница со списком сущностей CRM. Для каждой из них есть две кнопки: Добавить шаблон (создание нового шаблона БП) и Список шаблонов (посмотреть весь список шаблонов БП). Создание бизнес-процессов доступно для следующих [dw]сущностей CRM[/dw][di]На скриншоте Реестр документов – это смарт-процесс.
[/di]:

• Лид
• Контакт
• Компания
• Сделка
• Коммерческое предложение
• Счета (новые) (с версии crm 21.1300.0)
• Смарт-процессы
  Примечание: В настройках смарт-процесса должна быть включена опция [dw]Использовать в смарт-процессе дизайнер бизнес-процессов[/dw][di]
  
  Подробнее о работе со смарт-процессами в статье helpdesk.bitrix24.ru.[/di], чтобы он был доступен для использования в бизнес-процессах. Для каждого смарт-процесса с включенной опцией отобразится отдельная строка в этом списке с названием смарт-процесса и возможностью создавать шаблоны.

  Особенности создания шаблонов

В дизайнере бизнес-процессов для сущностей CRM присутствует одноименный раздел с действиями, в основном доступными только для CRM:

Набор доступных действий различен для каждой сущности. Некоторые отображаются только для Сделок, а некоторые только для Смарт-процессов, и т.д.

Описание работы с этими действиями находится в главе курса Действия > CRM.

  Запуск бизнес-процесса

Запуск бизнес-процесса для элементов CRM выполняется аналогично другим БП: автоматически при изменении или при добавлении элемента (зависит от настроек шаблона). Также возможен ручной запуск из списка элементов или из карточки элемента.

В списке элементов воспользуйтесь меню для нужного элемента:

В карточке элемента перейдите в секцию Бизнес-процессы, где можно запустить новый бизнес-процесс по одному из шаблонов или посмотреть историю по завершенным БП:

  Дополнительно

• Автозапуск бизнес-процессов;
• Видео-курс о бизнес-процессах.

  Административная часть

В административной части есть два способа открытия списка шаблонов бизнес-процессов. Рекомендуемый нами (более удобный) способ вызова визуального конструктора: перейдите к желаемому инфоблоку и нажмите на контекстной панели кнопку Шаблоны бизнес-процессов.

После чего используйте меню кнопки Создать шаблон на контекстной панели или команду меню действий [dw]Изменить[/dw][di][/di].

  Публичная часть

Переход к визуальному конструктору отличается для разных типов документов . Обычно это пункт меню с соответствующей подписью. Для универсальных списков это выглядит так:

А так для Диска:

Далее воспользуйтесь кнопками создания бизнес-процессов или отредактируйте существующий с помощью кнопки [dw]Изменить[/dw][di][/di] в меню действий.

  Внешний вид

Визуальный конструктор состоит из четырех областей. Его вид будет отличаться в зависимости от того, какой процесс редактируется.

  1. Контекстная панель

Контекстная панель визуального конструктора состоит из набора кнопок:

• Параметры шаблона – позволяет задать/изменить [dwi include_bp_template]основные параметры[/dwi] и параметры запуска бизнес-процесса;
• Глобальные переменные – переход к списку глобальных переменных;
• Глобальные константы – переход к списку глобальных констант;
• Список шаблонов – переход к списку шаблонов бизнес-процессов;
• Создать шаблон <тип_бизнес-процесса> – позволяет перейти к созданию одного из типов бизнес-процессов;
• [ds]Экспорт и Импорт[/ds][di]Процесс переноса шаблона с одного проекта на другой достаточно простой. Для этого необходимо воспользоваться кнопками на контекстной панели дизайнера бизнес-процессов.
  Подробнее...[/di] – экспорт текущего шаблона бизнес-процесса и импорт шаблона бизнес-процесса взамен текущего.

  2. Основная рабочая область

Внешний вид основной рабочей области зависит от типа БП: [dwi include_bp_sequential]последовательный бизнес процесс[/dwi] или [dwi include_bp_state_driven]бизнес-процесс со статусами[/dwi].

Создание и редактирование шаблона бизнес-процесса, т.е. добавление некоторых действий, осуществляется простым [dw]перетягиванием действия [/dw][di][/di] на основную рабочую область конструктора в нужном месте шаблона бизнес-процесса. Или воспользуйтесь меню, которое доступно при нажатии на [dw]треугольник[/dw][di][/di] между действиями.

Для копирования действий перетащите уже существующее действие, зажав клавишу Ctrl. Для удаления действия служит кнопка , а для выполнения детальной настройки размещенного в шаблоне действия – кнопка . Некоторые действия [dw]сворачиваются[/dw][di][/di] для экономии места на экране .

  3. Панель действий конструктора

Панель действий визуального конструктора содержит набор [dw]действий[/dw][di]Последовательный бизнес-процесс строится из набора действий. Каждое действие выполняет определенную функцию и имеет собственные параметры.
Подробнее...[/di], из которых и производится конструирование шаблона.

'CATEGORY' => array(
        'ID' => 'document',
        "OWN_ID" => 'crm',     // идентификатор новой создаваемой группы действий
        "OWN_NAME" => 'CRM',     // название группы, которое будет отображаться в дизайнере
    ),

  4. Кнопки управления

Если осуществляется создание/редактирование шаблона последовательного бизнес-процесса, то отображаются кнопки: Сохранить, Применить и Отмена.

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

Примечание: Если шаблон был изменен, но не сохранен, то при попытке покинуть страницу появится [dw]предупреждение[/dw][di][/di] о возможной потере несохраненных данных, с возможностью сохранить изменения.

  Заключение

Мы узнали, где запустить Визуальный конструктор и как проектировать в нем шаблоны бизнес-процессов. Инструмент, с помощью технологии drag&drop, позволяет наглядно и удобно создавать и редактировать шаблоны бизнес-процессов.

  Глобальные переменные и константы

На контекстной панели [ds]визуального конструктора[/ds][di]Контекстная панель визуального конструктора состоит из набора кнопок:

Подробнее...[/di] расположены две кнопки: Глобальные переменные и Глобальные константы. По нажатии на кнопку открывается слайдер со списком глобальных переменных или констант соответственно.

  Процесс создания

Процесс создания одинаков для глобальных переменных и констант, поэтому рассмотрим его на примере создания глобальной переменной.

По нажатии на кнопку Глобальные переменные открывается слайдер со списком всех, [dw]доступных[/dw][di]Зависит от параметра переменной Видимость.[/di] в этом процессе, глобальных переменных. Нажмем на кнопку Создать переменную – откроется слайдер с параметрами:

• Название – название глобальной переменной;
• Тип – тип переменной из списка;
• Множественность – является ли переменная множественной (имеет несколько значений);
• Значение – значение переменной;
• Видимость – где использовать переменную:
  • Везде – переменная доступна во всех процессах (CRM, списки, диск и т.д.);
  • CRM – переменная доступна только в процессах CRM (БП сделок, лидов, счетов и т.д.);
  • [Сущность CRM] – переменная доступна только в процессах выбранной сущности CRM (например, только в сделках или только в счетах). Для выбора в списке всегда будет доступна только та сущность CRM, для которой открыт шаблон бизнес-процесса.

  В 1С-Битрикс: Управление сайтом доступен только вариант видимости Везде.

• Описание – произвольный текст для описания переменной.

С версии 23.200.0 модуля Бизнес-процессы добавлена валидация значений и опций. В случае, если переменная / константа не могут быть сохранены, отображается подсказка с пояснением [dw]причины[/dw][di]Например, если превышен максимальный объем информации:

[/di].

  Удаление

[dw]Групповое удаление[/dw][di]С версии модуля Бизнес-процессы 21.700.0.[/di] глобальных переменных и констант выполняется из списка:

• Отметьте в списке глобальные переменные / константы, которые требуется удалить;
• Нажмите кнопку Удалить под списком.

Отдельную переменную / константу можно удалить через меню элемента списка.

  Практические задания

После изучения главы Дизайнер бизнес-процессов рекомендуем выполнить несколько практических заданий. Выполнять их необходимо на установленной на локальный компьютер [ds]пробной версии Битрикс24 в коробке[/ds][di]В главе описаны предварительные шаги для установки продукта, шаги мастера установки, а также выбор и первоначальная настройка портала для быстрого развертывания своего проекта.

Подробнее...[/di].

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

1. Перейдите в Административную часть и настройте инфоблок Оргструктура > График отсутствий на участие в бизнес-процессах. Затем, перейдите к списку шаблонов этого инфоблока и откройте визуальный конструктор для шаблона Двухэтапное утверждение (это можно сделать двумя способами).

   Решение
   Задание составлено по материалу уроков: Настройка инфоблоков на работу с бизнес-процессами; Визуальный конструктор. Результат:

2. Перейдите в публичную часть портала. Откройте список шаблонов бизнес-процессов для Сделок (CRM). Создайте новый пустой шаблон последовательного бизнес-процесса.

   Решение
   Задание составлено по материалам уроков: Бизнес-процессы в CRM; Визуальный конструктор. Результат:

3. Откройте на редактирование шаблон, созданный в задании № 2. Изучим работу с визуальным конструктором:
   • Добавьте в рабочую область действия «Сообщение соц. сети» и «Цикл». Используйте для этого разные способы (треугольник и перетаскивание);
   • Разместите [dw]копию[/dw][di]Помните про копирование при помощи клавиши Ctrl?[/di] действия «Сообщение соц. сети» внутри цикла;
   • Сверните действие «Цикл», а одно из действий «Сообщение соц. сети» – удалите.
   • Попробуйте сохранить шаблон бизнес-процесса и изучите возникшую ошибку. О чём она сообщает?

   Решение
   Задание составлено по материалам уроков: Из чего состоит визуальный конструктор. Результат:

Где выполнять задания?

Выполнять их необходимо на установленной на локальный компьютер [ds]пробной версии Битрикс24 в коробке[/ds][di]В главе описаны предварительные шаги для установки продукта, шаги мастера установки, а также выбор и первоначальная настройка портала для быстрого развертывания своего проекта.

Подробнее...[/di]. Демоверсия работает 30 дней.

Самый простой способ – это подготовить демоверсию с помощью виртуальной машины. Подробная информация об установке представлена в уроке Где практиковаться и выполнять задания.

  Создание шаблона

Процесс проектирования шаблона бизнес-процесса разделим на два этапа:

• Первый - это задание основных параметров шаблона;
• Второй - конструирование шаблона, по которому будет выполняться бизнес-процесс.

Второй этап рассматривается в следующих уроках. А в этом уроке остановимся на первом этапе. Форма настройки параметров шаблона бизнес-процесса разделена на несколько закладок, с помощью которых задаются параметры запуска и настройки бизнес-процесса.

  Основное

На закладке Основное указываются название шаблона бизнес-процесса, его описание и определяются параметры автоматического запуска. Бизнес-процесс имеет два варианта автоматического запуска: при создании и/или при изменении элемента. Если оба флага сняты, то бизнес-процесс возможно запустить только вручную.

  Параметры

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

Для создания параметра нажимаем ссылку Добавить параметр на закладке Параметры и заполняем [dw]поля[/dw][di]Так выглядит форма создания для параметра типа Пользователь:

[/di] в форме:

• Идентификатор - символьный идентификатор параметра;
• Описание - произвольное описание параметра;
• Тип - с помощью выпадающего списка указывается тип данных параметра запуска;
• Обязательный - при отмеченной опции параметр будет обязательным для заполнения и бизнес-процесс не запустится без указания значения параметра;
• Множественный - при отмеченной опции может быть задано несколько значений параметра;
• Значение по умолчанию - указывается значение параметра, установленное по умолчанию. Вид поля меняется в зависимости от выбранного типа;
  Примечание: для некоторых типов данных значение по умолчанию можно указать с помощью кнопки [...], по нажатии которой открывается форма [dwi include_bp_insert_value_form]Вставка значения[/dwi].

Перечисленные выше поля - общие для всех типов параметров. Также для некоторых типов доступны дополнительные поля. Например, для типа Список появится поле Варианты значений для составления значений списка. А для типа Привязка к элементам в виде списка - поле выбора инфоблока.

После создания параметр отобразится в [dw]общем списке[/dw][di][/di] параметров.

При запуске бизнес-процесса будут запрошены значения для этих параметров. Например так:

  Переменные и Константы

Переменные и константы создаются аналогично параметрам.

 Переменные

Переменные используются для временного хранения данных, необходимых для выполняемого процесса. Значения переменных хранятся до тех пор, пока выполняется бизнес-процесс. После его завершения они [dw]все стираются[/dw][di]Поэтому если необходимо куда-то сохранять переменную, например файл, добавленный пользователем, то следует использовать действие Изменение документа. С помощью него значение переменной сохраняется в предварительно созданное дополнительное поле документа соответствующего типа (файл, например).[/di].

В отличие от параметров бизнес-процесса, значения переменных могут быть изменены по ходу бизнес-процесса действием [dwi include_bp_change_variables]Изменение переменных[/dwi].

 Константы

Константы нужны для хранения информации, значение которой не должно меняться во время исполнения данного процесса. Их значение настраиваем до запуска бизнес-процесса. Константы добавляются по ссылке Добавить константу на соответствующей закладке. При этом откроется [dw]вкладка[/dw][di][/di] создания константы. В поле Значение константы указываем, какое значение имеет константа в процессе исполнения бизнес-процесса.

  Доступ

На закладке Доступ для пользователей задаются начальные права, которые устанавливаются для документа при его запуске. Причем права доступа [dw]задаются[/dw][di][/di] как явно, так и с помощью переменных.

Особенности назначения прав в системе

Если для документа используется [ds]упрощенная[/ds][di]Простой режим настройки прав доступа к инфоблоку - это режим, когда опция Расширенное управление правами отключена, а в секции Доступ для групп пользователей перечислены все имеющиеся у вас в системе группы пользователей.
Подробнее...[/di] (старая) версия прав, то они устанавливаются жестко извне (настройки доступа к инфоблокам/спискам/и т.д.). Единственный вариант, позволяющий устанавливать права прямо из бизнес-процесса - это установка для документа права бизнес-процессы извне (права на сам документ). В этом случае с помощью закладки Доступ или действия Установка прав можно менять права по ходу выполнения процесса.

Если используются [ds]расширенные права[/ds][di]Расширенный режим позволяет настроить права доступа не только целиком ко всему инфоблоку, но и гибко задать права на отдельные его разделы и элементы.
Подробнее...[/di] доступа, то из бизнес-процесса можно только добавлять новые права на документ, которые будут оставаться у документа даже после выполнения процесса. Переопределить права, которые были установлены извне, внутри бизнес-процесса нельзя.

  Видеоурок

  Создание шаблона последовательного БП

При проектировании шаблона последовательного бизнес-процесса после [dwi include_bp_template]настройки и сохранения его параметров[/dwi] сразу становится доступным визуальный конструктор для конструирования шаблона.

Конструирование шаблона выполняется путем [dw]добавления в рабочую область[/dw][di][/di] необходимых действий с последующей настройкой их параметров.

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

Заполните необходимые поля. Для упрощения процедуры заполнения полей служит кнопка , при нажатии которой открывается зависящая от типа поля форма [dwi include_bp_insert_value_form]Вставка значения[/dwi].

Для выбора значения откройте нужную группу, затем выберите необходимое значение и нажмите кнопку Вставить (либо дважды кликнете по выбранному значению). Для вставки нескольких значений необходимо повторно вызвать форму выбора значения. Значение или его код будут подставлены в настраиваемое поле (На иллюстрации выше такой код выделен красной рамочкой).

По окончании настройки параметров действия, сохраните его. Система вернется к созданию (редактированию) шаблона бизнес-процесса.

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

  Видеоуроки

Содержание видеоурока отличается от текущей версии продукта. Более актуальная информация содержится в тексте урока.

  Создание статусов

Создание статусов выполняется на главной странице построения шаблона бизнес-процесса:

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

  

  Внимание: в версиях модуля до 21.400.0 смена начального статуса бизнес-процесса невозможна.
  До версии 21.400.0 модуля Бизнес-процессы работа со статусами была более строгой. Отсутствовала возможность менять статусы местами и изменять начальный статус. Важно! В БП со статусами до версии 21.400.0 бизнес-процесс всегда начинается с первого созданного статуса. Изменить статус, с которого начинается процесс, в последующем невозможно.



• В форме создания статуса укажите его название и права доступа к документу (элементу бизнес-процесса), если таковые имеются. Набор настроек прав доступа зависит от типа элемента.
  Примечание: Добавляйте пользователя или группу пользователей только к одному праву доступа (максимальному). Если добавите в несколько прав доступа – применится самое слабое (верхнее в списке) право.
• Сохраните изменения.

Аналогичным образом добавляются все необходимые статусы. Например, в шаблон могут быть добавлены такие статусы:

.

Все созданные статусы можно [dw]менять местами[/dw][di]Такая возможность стала доступна с версии 21.400.0 модуля Бизнес-процессы.[/di] путем перетаскивания, как вам удобно для построения шаблона. При этом связи статусов сохраняются.

  Настройка действий и создание связей

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

Для каждого статуса настраивается:

• Действие [dw]Команда[/dw][di]Действие сходно по смыслу действию Команда для шаблона последовательных бизнес-процессов.[/di], которое позволяет пользователю вручную запускать подпроцесс. Внешний вид элемента управления, с помощью которого пользователем запускается команда, зависит от места запуска бизнес-процесса и типа документа. Команду используем, например, для определения того, как должен исполняться бизнес-процесс. Или как подпроцесс, который выполняется только при определенных условиях;
• Действие [dw]Выполнение через заданное время[/dw][di]Действие сходно по смыслу действию Пауза в выполнении для шаблона последовательных бизнес-процессов.
  
  Подробнее...[/di] – позволяет [dw]отложить[/dw][di]Действие удобно использовать, например, если необходимо автоматически выполнить какие-то действия без участия сотрудников[/di] выполнение подпроцесса на заданное в обработчике время;
• Обработчик входа в данный статус – отдельный последовательный бизнес-процесс. Всегда выполняется автоматически при входе в данный статус;
• Обработчик выхода из данного статуса – отдельный последовательный бизнес-процесс. Всегда выполняется автоматически при [dw]выходе[/dw][di]Например, можно отправлять информационное сообщение, что процесс вышел из текущего статуса.[/di] из данного статуса.

  Настройка прав доступа

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

Набор прав доступа зависит от типа документа. Так для [dw]универсальных списков[/dw][di][/di] доступна настройка 8 типов, а для [dw]инфоблоков[/dw][di][/di] всего 2. Для сущностей CRM настройка дополнительных прав в статусе отсутствует.

С версии 23.200.0 добавлена возможность гибко настраивать права на статус. Теперь, аналогично действию [ds]Установка прав[/ds][di]Действие позволяет устанавливать права на доступ к документу.

Подробнее...[/di], доступно выбрать, что сделать с текущими правами документа, и определить область применения очистки или перезаписи прав.

  Рассмотрим для чего нужна такая настройка прав доступа на простом примере организации проверки вновь добавленных элементов руководителем. Пусть сотрудники могут видеть и редактировать вновь добавленный ими элемент до тех пор, пока руководитель не утвердит его. После утверждения элемент сотруднику не доступен.

1. В настройках универсального списка укажем следующее право доступа: Сотрудники = добавление. После такой настройки прав сотрудник сможет добавлять элементы в список, но не сможет просматривать или изменять их.
2. Теперь в настройках прав доступа требуемого статуса бизнес-процесса укажем, что право на Изменение имеет Автор.
3. Право из бизнес-процесса добавится к правам на список. Произойдет сопоставление понятия Автор с конкретным пользователем в системе и его правами в списке. После такой настройки пользователь сможет изменять элемент до тех пор, пока он находится в текущем статусе бизнес-процесса. Как только руководитель утвердит документ и бизнес-процесс перейдет в другой статус, сотрудник больше не будет иметь доступа к элементу.

  Общая схема работы (Битрикс24)

При входе в статус первым всегда выполняется Обработчик входа в данный статус, если он задан. После выполнения всех внутренних действий статуса бизнес-процесс переходит в режим ожидания. Для дальнейшего продолжения процесса можно воспользоваться подпроцессами Выполнение через заданное время и Команда.

Если статус не является конечным, то переход от одного статуса к другому (создание связей) выполняется с помощью действия [dwi include_bp_set_status]Установить статус[/dwi], которое должно располагаться внутри подпроцесса, предполагающего такой переход. При выходе из статуса автоматически будет выполнен подпроцесс Обработчик выхода из данного статуса, если он создан.

  Начальные действия

• Создадим 3 статуса:
  • Рассмотрение документа
  • Доработка
  • Утвержден
• В каждом добавим подпроцесс Вход в статус.

  

  Cтатус Рассмотрение документа

• Перейдем в статус и добавим действие [ds]Утверждение документа[/ds][di]Действие позволяет произвести утверждение документа, для которого запущен бизнес-процесс.
  
  Подробнее...[/di]. В параметрах действия заполним [dw]все обязательные поля[/dw][di][/di]. Поле Описание задания пока оставим пустым, мы к нему вернемся позже;
• Добавим действие [dwi include_bp_set_status]Установить статус[/dwi] в каждую ветку утверждения документа, после чего произведем их настройку для статусов [dw]Утвержден[/dw][di][/di] и [dw]Доработка[/dw][di][/di].

Получится такой процесс:

В случае если проверяющий сотрудник утвердит документ, то бизнес процесс перейдет в статус Утвержден, иначе - в статус Доработка.

  Статус Доработка

• Перейдем в статус и добавим действие [ds]Запрос дополнительной информации[/ds][di]Действие создает задание, в ходе которого у пользователя будет запрошена дополнительная информация необходимая для выполнения бизнес-процесса.
  Подробнее...[/di]. В Поле Описание задания, используя форму [dwi include_bp_insert_value_form]Вставка значения[/dwi], добавим [dw]комментарий[/dw][di][/di], который будет оставлен проверяющим после выполнения действия Утверждение документа (Утверждение документа > Комментарий, группа Дополнительные результаты).

  

• Далее добавим действие Установить статус и произведем его настройку для возврата документа в статус Рассмотрение (для повторного рассмотрения после доработки):

  

• Вернемся в статус Рассмотрение документа к настройке действия Утверждение документа. Аналогично предыдущему пункту, в поле Описание задания, используя форму [dw]Вставка значения[/dw][di][/di], добавим [dw]комментарий[/dw][di][/di]. Это будет комментарий, который оставит автор документа после выполнения действия Запрос дополнительной информации (из статуса Доработка).

В результате в этом статусе мы получим от автора нужные исправления/комментарии и отправим документ на повторное утверждение.

  Статус Утвержден

В этом статусе можно проинформировать автора документа об утверждении документа, например, с помощью действия [dwi include_bp_message]Сообщение соц. сети[/dwi]. А также добавим действие [ds]Прерывание процесса[/ds][di]Действие позволяет прекратить выполнение бизнес-процесса.

Подробнее...[/di], для завершения нашего бизнес-процесса после уведомления автора.

  Итоги и шаблон для ознакомления

В итоге, после всех настроек, наш бизнес процесс со статусами в общем виде выглядит так:

  Шаблон для ознакомления: Скачать. После загрузки шаблона его нужно импортировать на вашу установку "1С-Битрикс: Управление сайтом" или "Битрикс24" и открыть его в ней.

  Как перенести шаблон

Процесс переноса шаблона с одного проекта на другой достаточно простой. Для этого необходимо воспользоваться кнопками «Экспорт» и «Импорт» на контекстной панели [dw]дизайнера бизнес-процессов[/dw][di]Модуль Дизайнер бизнес-процессов, входящий в старшие редакции продуктов «1С-Битрикс», предназначен для проектирования, создания и изменения бизнес-процессов.
Подробнее...[/di].

При нажатии на кнопку «Экспорт» скачивается файл формата bpt. Например: bp-5.bpt, где 5 это идентификатор шаблона бизнес-процесса. Этот файл вы затем можете импортировать на другой проект.

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

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

Проще всего выполнять импорт в «пустой» документ. Тогда вместе с шаблоном будут созданы все необходимые поля. В остальных случаях внимательно проверьте список полей, полученный после импорта шаблона.

  Особенности импорта шаблона списков

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

Наиболее простой вариант - это изначально создать и настроить список, поля и шаблон бизнес-процесса:

• Создать пользовательские поля в исходном списке не через интерфейс списков, а прямо через интерфейс конструктора бизнес-процессов;
• После экспорта шаблона из исходного списка в новый обязательно проверить все действия, где используются пользовательские поля.

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

• Создать и настроить новый список также как и исходный;
• Создать и настроить через публичный интерфейс модуля списков такие же поля, как и в исходном списке;
• Задать для пользовательских полей и их значений (например, для полей типа список) такие же идентификаторы, как и в исходном списке через административную часть сайта;
• Импортировать шаблон бизнес-процесса;
• Обязательно проверить получившийся после импорта шаблон, особенно те действия, где используются пользовательские поля.

При несоблюдении указанных условий шаблон и пользовательские поля могут некорректно импортироваться.

  Практические задания

После изучения главы Шаблоны бизнес-процессов рекомендуем выполнить несколько практических заданий. Выполнять их необходимо на установленной на локальный компьютер [ds]пробной версии Битрикс24 в коробке[/ds][di]В главе описаны предварительные шаги для установки продукта, шаги мастера установки, а также выбор и первоначальная настройка портала для быстрого развертывания своего проекта.

Подробнее...[/di].

1. В процессах ленты новостей создайте новый процесс с названием Взять оплачиваемый отгул. Cоздайте для него шаблон последовательного БП, автоматически запускаемого при добавлении элемента. Добавьте в шаблон:
   • два обязательных параметра:
   • типа Дата, для указания даты взятия отгула;
   • типа Список, для указания причин взятия отгула. Пусть причин будет две: за работу в выходной и за особые заслуги.
   • одну переменную типа Деньги, для указания размера оплаты дня отгула.
   
   Сохраните шаблон.

   Решение
   Задание составлено по материалу уроков: Настройка параметров шаблона; Создание шаблона последовательного бизнес-процесса. Результат:



2. Продолжим создание шаблона, начатого в задании № 1. Задействуйте созданные параметры и переменные в шаблоне:
   • Пусть размер оплаты меняется в зависимости от указанной причины отгула (используйте действия [dwi include_bp_if]Условие[/dwi] и [dwi include_bp_change_variables]Изменение переменных[/dwi]);
   • Пользователь, запустивший БП, должен получить уведомление, что отгул на указанную дату одобрен и узнать сумму оплаты (используйте действие [dwi include_bp_message]Сообщение соц. сети[/dwi]).
   Сохраните шаблон и проверьте результаты его работы.

   Решение
   Задание составлено по материалам уроков: Настройка параметров шаблона; Создание шаблона последовательного бизнес-процесса. Результат:



3. Создайте новый список в Сервисы > Списки. Импортируйте для созданного списка шаблон бизнес-процесса со статусами из урока Пример: организация обработки и доработки документа. Изучите шаблон и проверьте его работу, создав новый элемент списка.

   Решение
   Задание составлено по материалам уроков: Создание шаблона бизнес-процесса со статусами; Пример: организация обработки и доработки документа. Результат:



4. Отредактируйте шаблон из задания № 3. Добавьте новый статус Публикация документа, следующим после Утверждение. Настройте статусы:
   • В статусе «Утвержден» удалите прерывание процесса. Запросите [dw]дополнительную информацию[/dw][di]Используйте действие Запрос дополнительной информации и создайте поле в настройках этого действия.[/di] у автора документа – группу пользователей, на которую будет опубликована информация о документе в ленте Новостей. Измените текст уведомления на более осмысленный;
   • В новом статусе добавьте действие [ds]Добавить новость[/ds][di]Действие создаёт пост на сотрудников в ленте новостей.
     
     Подробнее...[/di]. Пусть в сообщении будет информация о названии документа и дате создания. Публиковаться пост должен только для группы или пользователей, указанных в статусе ранее автором.

   Решение
   Задание составлено по материалам уроков: Создание шаблона бизнес-процесса со статусами. Результат:



5. * Дополнительное задание «Шаблоны для процесса в ленте новостей»

   Задание под спойлером

   Создайте простой бизнес-процесс, функция которого показывать уведомление при создании элемента. Для этого выполните шаги: создайте процесс; настройте доступ: полный доступ для Администраторов и добавление для сотрудников; создайте шаблон последовательного бизнес-процесса, который запустится при создании элемента; в конструкторе используйте действие [dwi include_bp_message]Сообщение соц. сети[/dwi]; отправитель сообщения – Автор сообщения, получатель – Автор и Администраторы; в сообщении выведите информацию о названии элемента, авторе и дате создания. Решение Задание составлено по материалам уроков: Бизнес-процессы организации; Дизайнер бизнес-процессов; Создание шаблона последовательного бизнес-процесса; Форма "Вставка значения"; Сообщение соц.сети. Результат: Добавьте ещё один шаблон в процесс, созданный в предыдущем задании, который будет показывать уведомление при изменении элемента. Он не должен быть доступен при ручном запуске. В сообщении выводите ID элемента, кем изменен и дату изменения, а получателем установите группу Администраторы. Решение Задание составлено по материалам уроков: Бизнес-процессы организации; Дизайнер бизнес-процессов; Создание шаблона последовательного бизнес-процесса; Форма "Вставка значения"; Сообщение соц.сети. Результат: Добавьте процесс в ленту новостей (ранее, живая лента). Затем создайте новый элемент из ленты новостей. Решение Задание составлено по материалам уроков: Бизнес-процессы организации. Результат: Последовательно удалите: запущенный для элемента процесс; сам элемент; шаблоны бизнес-процессов; процесс. Решение Результат:

Где выполнять задания?

Выполнять их необходимо на установленной на локальный компьютер [ds]пробной версии Битрикс24 в коробке[/ds][di]В главе описаны предварительные шаги для установки продукта, шаги мастера установки, а также выбор и первоначальная настройка портала для быстрого развертывания своего проекта.

Подробнее...[/di]. Демоверсия работает 30 дней.

Самый простой способ – это подготовить демоверсию с помощью виртуальной машины. Подробная информация об установке представлена в уроке Где практиковаться и выполнять задания.

  Форма

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

  Разделы формы

• [ds]Параметры шаблона[/ds][di]Параметры используются для явного указания каких-либо значений во время исполнения бизнес-процесса.
  
  Подробнее...[/di] – вставка параметров шаблона. Задаются для конкретного шаблона в форме, доступной по кнопке Параметры шаблона на контекстной панели визуального конструктора бизнес-процесса. Значение параметра - то, что введет пользователь в соответствующих полях при запуске бизнес-процесса.
• [ds]Переменные[/ds][di]Переменные используются для временного хранения данных, необходимых для выполняемого процесса.
  
  Подробнее...[/di] – вставка пользовательских переменных, которые могут изменяться по ходу выполнения бизнес-процесса. Пример: дополнительное числовое поле, заполняемое пользователем в процессе выполнения бизнес-процесса.
• [ds]Константы[/ds][di]Константы нужны для хранения информации, значение которой не должно меняться во время исполнения данного процесса.
  
  Подробнее...[/di] – вставка заранее заданных констант, которые остаются неизменными в процессе исполнения бизнес-процесса. Их значение задается в параметрах шаблона и пользователь, не имеющий доступа к изменению процессов, не может менять их значение.
• [ds]Глобальные константы[/ds][di]Глобальные константы используются для хранения данных и имеют постоянное (неизменяемое) значение. Доступны сразу во всех шаблонах бизнес-процессов.
  
  Подробнее...[/di] – вставка значения глобальной константы, т.е. неизменяемого значения которое доступно во всех процессах.
• [ds]Глобальные переменные[/ds][di]Глобальные переменные используются для хранения данных и могут быть изменены. Доступны сразу во всех шаблонах бизнес-процессов.
  
  Подробнее...[/di] – вставка значения глобальной переменной, т.е. значения которое может быть изменено и доступно во всех процессах.
• Поля документа – вставка значения какого-либо поля документа, участвующего в бизнес-процессе. Например: Дата создания или Кем создан.
• Дополнительные результаты – вставка результатов выполнения некоторых действий. Не все действия предоставляют дополнительные результаты. В списке отображаются сразу все доступные результаты для всех действий, добавленных в текущий процесс, если они их поддерживают.
• Пользователи – вставка пользователя или группы пользователей, которые будут причастны к выполнению бизнес-процесса. Есть возможность выбрать несколько пользователей/групп пользователей. Для этого в качестве разделителя используется символ ;.

  Список отображаемых пользователей зависит от настроек доступа к документу. Например, при создании шаблона БП для сущности CRM, в настройках [ds]прав доступа в CRM[/ds][di]Права доступа в CRM необходимы для разделения зон ответственности при работе с клиентами.
  
  Подробнее на helpdesk.bitrix24.ru.[/di] требуется сначала для группы или пользователя установить роль с правами не ниже «Чтение» к [dw]элементам CRM[/dw][di]Например, если шаблон БП для сделок – то чтение к сделкам. Если БП для контактов – то чтение к контактам.[/di]. Только после этого сотрудники появятся в форме.

  Внимание: сотрудники не будут отображены в форме, если права в настройках CRM выданы отделу, а не группе или пользователю.
• Категории пользователей – позволяет подробно указать пользователей, которые будут причастны к выполнению бизнес-процесса. В том числе можно выбрать Отдел или Группу соцсети.

  Системные значения и функции

В действиях при проектировании бизнес-процесса есть возможность использовать системные значения и функции недоступные напрямую из формы. Их можно добавить двумя способами:

• Выбрать из списка. Для этого напишите в поле знак = и откроется список:

  

• Внести вручную.

Список системных значений:

• {=Workflow:ID} – идентификатор бизнес-процесса;
• {=Template:TargetUser} – параметр, в котором содержится идентификатор пользователя, запустившего бизнес-процесс в формате user_[номер_пользователя_в_системе];
• {=User:ID} – идентификатор [dw]текущего пользователя[/dw][di]Текущий пользователь это авторизованный пользователь, на чьем хите выполняется бизнес-процесс. Например, если бизнес-процесс выходит с паузы и при этом выполняется на агенте, то текущим может быть любой пользователь, на хите которого выполнился агент или событие.[/di] в формате user_[номер_пользователя_в_системе];
• {=System:Now} – текущая дата со временем на сервере;
• {=System:NowLocal} – текущая дата со временем у клиента (учитывается часовой пояс);
• {=System:Date} – текущая дата без времени;
• {=System:Eol} – символ конца строки;
• {=System:HostUrl} – URL сайта. Подставит значение вида https://mysite.ru. Доступно с версии 22.200.0 модуля Бизнес-процессы.

Список доступных операторов и функций с описаниями приведен в отдельном уроке Функции калькулятора выражений.

  Особенность для коробочной версии

Если для документа (инфоблока) было создано дополнительное свойство и оно не отображается в форме Вставка значения, то необходимо перейти к настройкам инфоблока в административной части сайта (Контент > Инфоблоки > Типы инфоблоков > [требуемый_инфоблок], вкладка Свойства), и в параметрах этого свойства отметить опцию Выводить на странице списка элементов поле для фильтрации по этому свойству:

После этого свойство информационного блока станет доступно для использования в бизнес-процессах.

  Заключение

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

  Операторы

Доступно использование следующих операторов для вычисления математических и логических выражений:

{{=if(or({=Variable:aaa}>2, {=Variable:bbb}<10), "yes", "no")}}

  Функции для вычислений

В действиях при проектировании бизнес-процесса есть возможность использовать функции. Их можно добавить двумя способами:

• Выбрать из списка. Для этого напишите в поле знак = и откроется список:

  

• Написать вручную или скопировать из примеров ниже, подставив свои значения.

Список функций с примерами:

{{=abs(-5)}}
// Результат: число 5

// Вычтем 2 дня
{{=dateadd({=Document:DATE_CREATE}, "-2d")}}
// Прибавим 2 дня и 3 минуты
{{=dateadd({=Document:DATE_CREATE}, "2 days 3 minutes")}}

{{=dateAdd({=Document:DATE_CREATE}, {=Variable:WHAT2ADD} & "y 10h")}}

{{=dateAdd({=Document:DATE_CREATE}, "-" & {=Variable:WHAT2ADD} & "y 10h")}}

{{=datediff({=Variable:Variable1}, {=Variable:Variable2},'%m month, %d days')}}

{{=date('l, j F Y, H:i:s')}}
// Результат: Tuesday, 9 November 2021, 12:06:16

// Пусть в параметре содержится дата 28.04.2016.
{{=workdateadd({=Template:Parameter1}, "2d", {=Document:ASSIGNED_BY_ID})}}
// Результат – 02.05.2016 09:00:00, т.к. 30.04 и 1.05 – это выходные дни, то они будут пропущены.
// 09:00:00 – начало рабочего дня. С помощью третьего параметра учитывается часовой пояс ответственного за сущность.

1. {{=addworkdays('07.03.2016', 1)}}
// результат: 09.03.2016 00:00:00, т.к. в настройках сайта 8 марта – выходной.
2. {{=addworkdays('05.02.2016 16:14:00', 1)}}
// т.к. 05.02.2016 – пятница, то результат: 08.02.2016 16:14:00 – понедельник.

// Пусть в параметре содержится дата 28.04.2016.
{{=if(isworkday({=Template:Parameter1}), 'Да', 'Нет')}}
// Результат – Да, т.к. это рабочий день.

// Пусть в параметре содержится дата 27.04.2016 15:00:00.
{{=if(isworktime({=Template:Parameter1}), 'Да', 'Нет')}}
// Результат – Да, т.к. это рабочее время.

 // 1. Добавление пользователя через форму Вставка значения, где "Кем создан" это поле документа
{{=touserdate({{Кем создан}})}}
// 2. Запись пользователя в формате user_ID, которую нужно взять в кавычки
{{=touserdate('user_1')}}
// 3. Пользователь в формате user_ID, дата и время указываются в кавычках
{{=touserdate('user_3', '18.07.2023 16:47:01')}}

// Группа Техподдержка имеет идентификатор 7
{{=touserdate(7)}}
// Первый пользователь в этой группе имеет часовой пояс (UTC -02:00). А значит время будет выведено в этом часовом поясе.

// Пусть время сервера UTC +03:00, а время пользователя (user_1) UTC +05:00. Тогда:
{{=getuserdateoffset('user_1')}}
// вернет 7200 (т.е. разница составляет 2 часа).

/* простой пример со строками в параметрах */
1. {{=if ({=Variable:Variable1_printable}>0, "да", "нет")}}
/* будьте внимательны, используя функции в параметрах.
Фигурные скобки и символ равно для dateadd здесь не нужны. */
2. {{=if ({=Template:Parameter1}=1, dateadd({=System:Now},"10d"), dateadd({=System:Now},"30d"))}}

{{=intval("234.34j4hv5jhv43v53jk4vt5hj4")}}
//вернет 234

{{=floatval("234.34j4hv5jhv43v53jk4vt5hj4")}}
//вернет 234.34

{{=numberformat(1300500.5, 2, ',', ' ')}}
//вернет 1 300 500,50

{{=min(5, 6, 18, 3, 7)}}
//вернет 3

{{=max(5, 6, 18, 3, 7)}}
//вернет 18

{{=rand(5, 10)}}
//вернет случайным образом число в диапазоне между 5 и 10. К примеру, 5 или 8.

{{=round(15.576, 2)}}
//вернет 15.58.

{{=ceil(15.57)}}
//вернет 16.

{{=floor(15.57)}}
//вернет 15.

{{=substr("0123456789", 3, 4)}}
// Вернет 3456.

1. {{=strpos('Тестовая строка', 'ст')}}
// Вернет 2.
2. {{=strpos('Тестовая строка', 'ст', 3)}}
// Вернет 9.

{{=strlen('Тестовая строка')}}
//вернет 15.

// Пусть переменная Variable1 - множественная и содержит три значения: Один, Два, Три. Тогда:
1. {{=implode(' - ', {=Variable:Variable1})}}
// вернет строку Один - Два - Три.
2. {{=implode('[br]', {=Variable:Variable1})}}
// тег bb-code br перенесёт каждое значение переменной на новую строку
3. {{=implode({=System:Eol}, {=Variable:Variable1})}}
// системное значение конца строки {=System:Eol} сработает там, где не поддерживается тег br (например, в Заданиях)

// {{=explode(' - ', 'Один - Два - Три')}}
// вернет массив из трёх строк: Один, Два, Три.

{{=randstring(10)}}
// Вернет случайную строку длиной в 10 символов. Например: yWB6pMU4S4
{{=randstring(16)}}
// Вернет случайную строку длиной в 16 символов. Например: zRNTpQ4r4zyoJXt0

{{= merge({=Document:FILES}, {=Variable:file})}}

{{=urlencode('Data123!@-_ +')}}
// Вернет закодированную строку Data123%21%40-_+%2B

{{=strtolower('Тестовая строка')}}
// Вернет тестовая строка

{{=strtoupper('Тестовая строка')}}
// Вернет ТЕСТОВАЯ СТРОКА

{{=ucwords('тестовая строка')}}
// Вернет Тестовая Строка

{{=ucfirst('тестовая строка')}}
// Вернет Тестовая строка

// Пусть текущие дата и время 18.07.2023 16:47:01. Тогда:
1. {{=strtotime("now")}}
// Вернёт 18.07.2023 16:47:01
2. {{=strtotime("next day")}}
//Вернёт 19.07.2023 16:47:01
3. {{=strtotime("+1 week")}}
//Вернёт 25.07.2023 16:47:01
4. {{=strtotime("next Thursday")}}
//Вернёт 20.07.2023 00:00:00

{{=locdate('l, j F Y, H:i:s')}}
Результат: Вторник, 9 Ноября 2021, 12:06:16

// Пусть есть переменная Variable1 типа Число с множественным значением: 1, 2, 3, 4, 5, 6. Тогда:
{{=shuffle({=Variable:Variable1})}}
// Вернет случайный порядок этих чисел. Например: 1, 4, 6, 5, 3, 2.

// 1. Пусть есть переменная Variable1 типа Число с множественным значением: 1, 2, 3, 4, 5, 6. Тогда:
{{=firstvalue({=Variable:Variable1})}}
// Вернет число: 1.
2. // В качестве параметра функции firstvalue используется функция explode
{{=firstvalue(explode(',' , {{Строка}}))}}

// Пусть есть переменная Variable1 типа Число с множественным значением: 1, 2, 3, 4, 5, 6. Тогда:
{{=swirl({=Variable:Variable1})}}
// Вернет: 2, 3, 4, 5, 6, 1, то есть число 1 стало последним.

// 1. Ссылка с форматированием bb-code:
{{=getdocumenturl('bb')}}
// 2. Полная ссылка с доменом сайта и html форматированием:
{{=getdocumenturl('html', true())}}

// Пусть есть переменная Variable1 типа Строка, в которой записано значение с пробелом в начале и в конце  123 .

// Используем функцию trim для записи значения переменной в отчет без пробелов:
{{=trim({=Variable:Variable1})}}
// В результате в отчет будет записано 123 без пробелов.

// Пусть есть переменная Variable1 типа Дата, в которой записана дата 13.03.2023.
// Используем функцию settime для установки времени:
1. {{=settime({=Variable:Variable1}, 15, 55)}}
// результат – 13.03.2023 15:55:00
2. {{=settime({=Variable:Variable1}, 21, 79)}}
// результат – 13.03.2023 22:19:00 (т.к. количество минут больше 60, был добавлен час и остаток записан в минуты)

  Вычисляем выражения

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

Пример для математической операции:

=6^2 + {=Document:PROPERTY_NUM}/2

Пример для логической операции с функцией if:

=if({Document:ID}=5, "текст1", "текст2")

В каждом поле доступно использовать сразу несколько разных вычислений.

Если Вы хотите не только произвести вычисление, но и вывести дополнительные данные (значение переменных, текст), то доступно два варианта написания:

• Вычисляемые значения можно просто размещать в тексте, поместив вычисление в конструкцию {{=...}}.
  Пример:

  Вам необходимо оформить документы до {{=DateAdd({=Document:CREATED}, '5d')}}



• Либо можно использовать оператор конкатенации (&), а текст написать в кавычках ( " или ' ). [dw]Пример[/dw][di][/di]:

  ='Ответ: ' & (1+3)

  или

  ="Автор: " & {=Document:CREATED_BY} & ", " & "Конечный срок: " & Dateadd({=Document:DATE_CREATE}, "1d")

  Как ставить кавычки

Система может неверно интерпретировать записанное вами выражение, когда в текстовых частях выражения присутствуют кавычки. Такой текст заключайте в кавычки, отличные от используемых в тексте. Например запись с конкатенацией текста, рассмотренная ранее в уроке, может быть изменена так:

// Слово Конечный в двойных кавычках, все текстовые части выражения в одинарных кавычках.
='Автор: ' & {=Document:CREATED_BY} & ', ' & '"Конечный" срок: ' & Dateadd({=Document:DATE_CREATE}, '1d')

// Слово Конечный в двойных кавычках, а фраза заключена в одинарные кавычки.
// Все остальные текстовые части выражения остались в двойных кавычках.
="Автор: " & {=Document:CREATED_BY} & ", " & '"Конечный" срок: ' & Dateadd({=Document:DATE_CREATE}, "1d")

  Как использовать скобки

Будьте внимательны при использовании фигурных скобок {{...}} или их автоматической подстановке, когда выбираете функции из списка. Неверная постановка скобок – это частая ошибка при работе с вычислениями выражений в бизнес-процессах.

Верная запись  

Если в поле нет дополнительного текста, то можно не писать фигурные скобки:

=datediff({{Дата создания элемента}},{{Дата изменения элемента}},"%a") * 2

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

{{=datediff({{Дата создания элемента}},{{Дата изменения элемента}},"%a") * 2}}

При использовании нескольких функций в одном выражении (например, в качестве параметров одной из функций), фигурные скобки и равно во вложенных функциях не нужны:

/* простой пример со строками в параметрах */
1. {{=if ({=Variable:Variable1_printable}>0, "да", "нет")}}
/* Если использовать функции в параметрах.
Двойные фигурные скобки и символ равно для dateadd здесь не нужны. */
2. {{=if ({=Template:Parameter1}=1, dateadd({=System:Now},"10d"), dateadd({=System:Now},"30d"))}}
/* В качестве параметра функции firstvalue используется функция explode */
3. {{=firstvalue(explode(',' , {{Строка}}))}}

Неверная запись  

Ниже показаны примеры неверное использование фигурных скобок при записи выражения:

={{=datediff({{Дата создания элемента}},{{Дата изменения элемента}},"%a")}} * 2
// или
{{={{=datediff({{Дата создания элемента}},{{Дата изменения элемента}},"%a")}} * 2}}

// для нескольких функций неверно писать так:
{{=if ({=Template:Parameter1}=1, {{=dateadd({=System:Now},"10d")}}, {{=dateadd({=System:Now},"30d"}}))}}
{{=firstvalue({{explode(',' , {{Строка}})}})}}

  Рекомендации

 Перенос вычислений в переменную

Для больших и сложных выражений удобен такой способ: перенести часть вычислений в [dw]переменную[/dw][di]Переменные используются для временного хранения данных, необходимых для выполняемого процесса. Значения переменных хранятся до тех пор, пока выполняется бизнес-процесс. После его завершения они все стираются.

Подробнее...[/di]. На примере выражения

=datediff({{Дата создания элемента}},{{Дата изменения элемента}},"%a") * 2

={=Variable:Variable2}*2

 Действие «Математические операции»

Для выполнения простых операций (сложение, вычитание и т.д.) со значениями переменных рассмотрите действие Математические операции.

  Список модификаторов

В таблице ниже собран список всех модификаторов с кратким примером записи. Модификатор добавляется через символ > внутри фигурных скобок. Примеры использования модификаторов есть в этом уроке и в последующих.

{=Variable:Variable1 > printable}

{=Document:CREATED_BY > friendly}

{=Variable:File > name}

{=Variable:Datetime > responsible}

{=Variable:Datetime > server}

{=Document:PROPERTY_MY_FILE > publink}

{=Document:PROPERTY_MY_FILE > shortlink}

{=Document:PROPERTY_MY_FILE > src}

{=Variable:Variable1 > bool}

{=Variable:Variable1 > date}

{=Variable:Variable1 > datetime}

{=Variable:Variable1 > double}

{=Variable:Variable1 > int}

{=Variable:Variable1 > file}

{=Variable:Variable1 > select}

{=Variable:Variable1 > string}

{=Variable:Variable1 > text}

{=Variable:Variable1 > user}

  Таблица преобразования типов данных

Для понимания, как можно преобразовывать типы данных мы подготовили специальную таблицу. В ней вы можете получить информацию о том, возможен ли перевод одно типа данных в другой. И если возможно, то каким будет результат.

  Примеры

printable

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

Возьмем переменную типа пользователь. Результат, если значение переменной равно Автор:

{=Variable:user}                          author
{=Variable:user > printable}              Автор

Для поля документа или параметра такой вариант отображения может быть сразу доступен для вставки в форме Вставка значения.

Если же печатная форма не предусмотрена, то запросить вывод печатной формы от любого значения получится и вручную (для переменной, дополнительного результата и т.п.). Кроме того, можно использовать модификаторы одновременно. Например, для переменной типа Datetime добавляем printable с преобразованием типа данных в Date:

{=Variable:Datetime > date, printable} // перевод даты в печатную форму

{=Variable:string>date} // преобразование строки в дату

friendly

Для данных типа Пользователь есть возможность преобразования в формат friendly. В таком случае выводится только имя и фамилия пользователя, без его ID и логина.

Пример: {=Document:CREATED_BY} > User_1

{=Document:CREATED_BY > printable} > Иван Иванов [1]

{=Document:CREATED_BY > friendly} > Иван Иванов

name

С версии 20.100.0 модуля Бизнес-процессы добавлена возможность получить имя файла через модификатор name для полей типа Файл. Пример для переменной типа Файл:

 {=Variable:File > name} // вывод названия файла

Другие примеры

• Примеры работы со ссылками;
• Примеры работы с датами.

  Пользователь

В параметрах действий, где указываются пользователи, для подстановки пользователя можно использовать код, состоящий из слова user и идентификатора ID.

В простом случае, запись с известным числовым ID в поле действия БП будет выглядеть так:

="user_5"

Если идентификатор является переменным и подставляется через форму Вставка значения (например, он записан в переменную или в какое-то поле документа), то в записи потребуется использовать оператор конкатенации &. Например:

="user_" & {=Variable:Variable1}

  Группы пользователей

В простом случае, запись с известным числовым ID в поле действия БП будет выглядеть так:

="group_D3"

Если идентификатор является переменным и подставляется через форму Вставка значения (например, он записан в переменную или в какое-то поле документа), то в записи потребуется использовать оператор конкатенации &. Например:

="group_SG" & {=A52792_89450_17178_72721:GroupId} & "_K"

  Сущности CRM

В действиях, не относящихся к разделу CRM, для добавления элементов через форму Вставка значения необходимо использовать [dw]поля документа[/dw][di][/di] вида Контакт: ID элемента CRM. Но такие поля есть не для всех сущностей и позволяют использовать только связанные с документом элементы CRM. Другой вариант - использовать следующий синтаксис:

• Контакты: ="C_"&{{ID}}
• Сделки: ="D_"&{{ID}}
• Лиды: ="L_"&{{ID}}
• Компании: ="CO_"&{{ID}}
• Счета (новые): ="SI_"&{{ID}}

Запись состоит из специального кода сущности, оператора конкатенации и идентификатора сущности. Идентификатором может быть переменная из формы Вставка значения. Так вы сможете использовать любые элементы CRM, не обязательно связанные с текущим документом.

Как привязать элемент смарт-процесса

Особенностью привязки элемента смарт-процесса является то, что у каждого смарт-процесса имеется свой уникальный префикс. В настоящий момент автоматически этот префикс пока не определяется, но вы можете определить его самостоятельно и выполнить привязку аналогично другим элементам CRM. Сначала определите Идентификатор типа смарт-процесса. Самый быстрый способ, это перейти на страницу списка Смарт-процессов (CRM > Настройки > Список смарт-процессов) и посмотреть в таблице в колонке Идентификатор типа смарт-процесса. Например, он может быть равен 174. Cконвертируйте данное число из десятичной системы в [dw]шестнадцатеричную[/dw][di]Например, с помощью конвертера https://www.translatorscafe.com/unit-converter/ru-RU/numbers/4-3/hexadecimal-decimal/.[/di]. В случае с идентификатором равным 174, получаем значение ae. Берем полученное значение в нижнем регистре (это важно!) и к полученному значению дописываем латинскую букву T в начале. Таким образом получаем префикс для конкретного смарт-процесса - Tae. Данный код используем в привязке в формате ="Tae_"&{{ID}}, где {{ID}} - числовой ID элемента смарт-процесса. Примечание: Также проверьте, чтобы для смарт-процесса была включена привязка к [dw]Задачам[/dw][di][/di]. Если привязка выключена - то и через действие бизнес-процесса привязка выполнена не будет.

 Пример привязки Контакта и Компании, связанных со сделкой, с помощью префиксов

Задача: при [ds]создании задачи[/ds][di]Действие Задача позволяет создать задачу.

Подробнее...[/di] из бизнес-процесса сделки, привязывать Контакт и Компанию, связанные с этой сделкой.

Для привязки Контакта нам понадобится использовать "C_"&, а для Компании - "CO_"&. В качестве идентификаторов этих элементов выберем в форме Вставка значения, секции Поля документа: Контакт: ID и Компания: ID.

Итоговая запись будет выглядеть так:

В результате при запуске БП в сделке будет создана задача с привязками к самой сделке (текущей сущности) и к связанными с ней Контакту и Компании:

  Использование переменных в ссылках

В полях действий, [dw]поддерживающих тег[/dw][di]Поля Описание задания позволяют использовать следующие теги bb-code:
Подробнее...[/di] [url], доступно использование собственных переменных для создания ссылок.

	[url=http://{=Variable:Domain}/{=Variable:Path}]название ссылки[/url]

  Создание прямой ссылки на страницу с заданием

Используйте ссылку, например, для отправки пользователю сообщения о необходимости выполнить задание в рамках бизнес-процесса.

	Ссылка на страницу с заданием: [url=https://[адрес_портала]/company/personal/bizproc/{=Workflow:ID}/]ссылка на страницу просмотра документа[/url]

Если заданий несколько

Если в бизнес-процессе есть несколько заданий, то прямую ссылку можно формировать не с использованием идентификатора бизнес-процесса ({=Workflow:ID}), а с выбором идентификатора конкретного задания через форму [dwi include_bp_insert_value_form]Вставка значения[/dwi], раздел [dw]Дополнительные результаты[/dw][di][/di].

Но вариант с использованием {=Workflow:ID} универсальный, так как открывает текущее невыполненное задание по конкретному бизнес-процессу. ID задания откроет конкретное задание этого процесса, даже если оно выполнено.

  Создание ссылки на страницу детального просмотра документа

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

	Ссылка на страницу детального просмотра документа: [url]{=Document:DETAIL_PAGE_URL}[/url]

Такое выражение работает для элементов инфоблоков и элементов универсальных списков.

  Создание публичной ссылки на файл

Для создания публичной ссылки на файл, не требующей авторизации на портале, используйте модификатор publink:

	Публичная ссылка на файл: {=Document:PROPERTY_MY_FILE > publink}
// где Document:PROPERTY_MY_FILE – свойство документа типа Файл

В результате получим ссылку вида: https://[адрес_портала]/bitrix/services/main/ajax.php?action=bizproc.file.show&token=305.0904b680f9932ca0ad3c378fb5159dac1a6521a6a9023408451a5e7a3a1061

  Создание короткой публичной ссылки

Намного удобнее прислать клиенту короткую ссылку на файл. Для создания такой ссылки воспользуйтесь модификатором shortlink, который генерирует короткую версию ссылки publink:

	Короткая публичная ссылка на файл: {=Document:PROPERTY_MY_FILE > shortlink}
// где Document:PROPERTY_MY_FILE – свойство документа типа Файл

В результате получим ссылку вида: https://[адрес_портала]/~tcMLt

  Создание прямой ссылки к файлу на сервере

Такой сценарий понадобится, если нужно отправить, например, ссылку на скачивание файла клиенту (т.е. кому-то извне).

Допустим, в документе имеется поле Файл. Для получения внутренней ссылки используем: вставка значения Поля документа > Файл (имя).

Ссылка на файл  - {=Document:PROPERTY_FILE_PRINTABLE}

Такая ссылка потребует авторизации на портале. Получить публичную ссылку можно с помощью модификатора src, который нужно указать вручную таким образом:

// удалим _PRINTABLE и добавим модификатор >src и bb-code [url].
Ссылка на файл - [url={=Document:PROPERTY_FILE > src}]link[/url]

  Перевод даты на русский язык

Для вывода даты используется функция [dw]date[/dw][di]date - Форматирует вывод системной даты/времени

[/di]. В примере используем параметр F - полное наименование месяца. Список всех параметров функции смотрите в документации по PHP.

Текущий месяц - {{=date('F',{=System:Date})}}

В результате получим [dw]уведомление[/dw][di][/di] вида Текущий месяц - April.

Для получения названия месяца на русском языке понадобится создать Список соответствия для названий месяцев. Введем переменную бизнес-процесса типа Список:

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

Вернемся к шаблону бизнес-процесса и перед сообщением соц.сети добавим действие [dw]Изменение переменных[/dw][di][/di] в котором укажем функцию {{=date('n')}}, где n - порядковый номер месяца без ведущего нуля (из документации по PHP).

В действии Уведомление соц. сети поменяем текст сообщения на вывод нашей переменной Variable1:

Текущий месяц - {=Variable:Variable1 > printable}

Результат:

Таким же образом можно выводить дни недели и др. подобные даты.

  Относительный формат даты

Задание: необходимо вывести дату - пятница следующей недели. Сделать это можно с помощью работы функции strtotime и относительных форматов PHP.

Создадим новую переменную [dw]Дата[/dw][di][/di] и снова воспользуемся действием Изменение переменных, как в примере выше. Укажем значение ='next week friday':

А в тексте сообщения соц. сети выведем переменную Дата.

Следующая пятница - {=Variable:Variable2 > printable}

Результат

  Добавление N дней из параметра

Сначала посмотрим на простой пример: прибавим к текущей дате точное количество дней.

Для этого понадобится функция dateadd:

Текущая дата + 2 дня: {{=dateadd({=System:Date}, '2d')}} // прибавим 2 дня к текущей дате

Теперь посмотрим, как правильно добавлять количество дней, которое хранится в параметре БП:

Текущая дата + N дней: {{=dateadd({=System:Date}, {=Template:Parameter1} & 'd')}} // прибавим дни из параметра к текущей дате

Результат (при запуске БП для параметра указано значение 10):

Таким же образом выполняется вычитание дней, только добавляется символ минуса:

Текущая дата - 2 дня: {{=dateadd({=System:Date}, '-2d')}} // отнимем 2 дня из текущей даты

Текущая дата - N дней: {{=dateadd({=System:Date}, '-' & {=Template:Parameter1} & 'd')}} // отнимем дни, указанные в параметре, из текущей даты

  Разница между двумя датами

Функция datediff() позволяет вычислять разницу между двумя датами.

Например, вычисление сколько дней прошло с момента создания элемента до текущего момента может выглядеть так:

{{=datediff({{Дата создания элемента}},{=System:NowLocal},"%d")}}

, где %d - значение параметра форматирования результата. Все значения параметра смотрите в документации PHP.

Для правильного использования функции, важно понимать, какой результат возвращает функция и как его использовать.

Возьмем две даты (с одинаковым днём):

• Date1: 18.01.2022 12:15:25
• Date2: 18.01.2022 18:31:00

Посчитаем разницу между этими датами:

{{=datediff({Date1},{Date2},"%h часов %i минут %s секунд")}}
// результат: 6 часов 15 минут 35 секунд

Если для этих же дат мы запишем функцию только со значением %i:

{{=datediff({Date1},{Date2},"%i")}}
// результат: 15

, то получим результат: 15. Т.о. функция datediff не переводит разницу в одну единицу времени (в минуты или в секунды). Её результатом всегда является расчет в полном формате (сколько прошло лет, месяцев, дней, часов и т.д. между двумя датами). А при помощи третьего параметра функции мы указываем лишь какие данные из этого результата отобразить.

Исключением является вариант %a, который выводит общее количество дней между датами. Проверим на том же примере, только для первой даты изменим год на 2020:

• Date1: 18.01.2020 12:15:25
• Date2: 18.01.2022 18:31:00

{{=datediff({Date1},{Date2},"%d")}}
// %d - количество дней
// результат: 0

{{=datediff({Date1},{Date2},"%a")}}
// %a - общее количество дней
// результат: 731

Как видим, в первом варианте количество дней равно 0, т.к. прошло ровно 2 года и 0 дней. А во втором варианте результат 731 день, т.е. количество дней за 2 года.

  Проверка корректности времени

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

	=if(and((intval(substr({=Template:Parameter1}, 0, 2)) >= 0), (intval(substr({=Template:Parameter1}, 0, 2)) < 25), (substr({=Template:Parameter1}, 2, 1) = ":"), (intval(substr({=Template:Parameter1}, 3, 2)) >= 0), (intval(substr({=Template:Parameter1}, 3, 2)) < 60)), {=Template:Parameter1}, "время указано неправильно")

Если в параметре {=Template:Parameter1} передается время (в 24 часовом формате ЧЧ:ММ, например 21:45), то возвращается его значение. Иначе вернется время указано неправильно.

  Дополнительно

• Функции калькулятора выражений.