Битрикс24 бизнес процесс php код

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

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

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

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

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

Комментарии к урокам

На каждой странице курса авторизованный на сайте посетитель может дать комментарий к содержимому страницы. Комментарий — не форум, там не ведётся обсуждений или разъяснений. Это инструмент для сообщений нам об ошибках, неточностях. Для отправки комментария воспользуйтесь расположенной в правом нижнем углу окна браузера кнопкой:

Баллы опыта

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

уроке.

Периодически мы заново оцениваем сложность уроков, увеличивая/уменьшая число баллов, добавляем новые уроки. Поэтому итоговое количество баллов курса и количество набранных вами баллов могут различаться между собой. Набранные вами баллы, в отличие от суммы баллов курса, не пересчитываются. Не переживайте!
Отличный результат — это если общее число набранных вами баллов отличается от максимального на несколько процентов.

Если нет интернета

Скачать материалы курса в формате EPUB. Файлы формата EPUB Чем открыть файл на
Android:
EPUB Reader
CoolReader
FBReader
Moon+ Reader
eBoox

iPhone:
FBReader
CoolReader
iBook
Bookmate

Windows:
Calibre
FBReader
Icecream Ebook Reader
Плагины для браузеров:
EpuBReader – для Firefox
Readium – для Google Chrome

iOS
Marvin for iOS
ShortBook

Linux:
Calibre
FBReader
Cool Reader
Okular обновляются периодически, поэтому возможно некоторое отставание их от онлайновой версии курса. Версия файла — от 06.06.2023.

Источник

#Действие: PHP код

Иногда возникает необходимость расширить стандартные возможности бизнес-процессов, а для этого в коробке есть большой набор инструментов, одним из которых является действие “PHP код”.

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

Позволяет расширять возможности бизнес-процессов
Занимают минимальное время на разработку

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

Читайте также: Php function echo value

#Правила

В случае если вы решили писать активити старайтесь следовать правилам:

Чем меньше кода тем проще его отладить. Старайтесь использовать код который можно отладить и без активити.
Оборачивайте код в try-catch блок ожидая Throwable. Таким образом вы предотвратите неожиданные и необьяснимые падения.
Записывайте все что может быть важно. Успешное выполнение, ошибка или неожиданное поведение.
Не используйте автозаменяемый битриксом код (Код автоматически заменяемый)
Не опирайтесь на глобальные переменные. Код может выполнять как на странице, так и на cron — переменная с текущим пользователем может быть пуста или заполнена не тем сотрудником. Идентификатора сайта может не быть.

#Журналирование

Для того чтобы делать записи в журнал бизнес-процесса существует специальный сервис журналирования ( TrackingService ) и быстрая log-функция \CBPActivity::WriteToTrackingService . Так как любое действие (активити) является наследником этого класса, то обращаться к нему можно через $this часть.

/** * @param string $message Message to log * @param int $modifiedBy Who modifier * @param int $trackingType Tracking type * @type void */ \CBPActivity::WriteToTrackingService($message = "", $modifiedBy = 0, $trackingType = -1): void

Параметрами данного метода являются:

$message (string) — Текстовая строка, которая будет записана в журнал бизнес-процесса.
$modifiedBy (int) — Идентификатор сотрудника, который будет записан в журнал. 0 — соответствует системе.
$trackingType (enum) — Тип сообщения (см. Типы сообщений).

Пример записи обычного сообщения в журнал:

$this->WriteToTrackingService( "Some message!", 0, \CBPTrackingType::Report );

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

#Типы сообщений

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

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

\CBPTrackingType::Error — Ошибки в процессе работы
\CBPTrackingType::Report — Примечания в процессе работы
\CBPTrackingType::Custom — Сообщения неопределенного типа
\CBPTrackingType::FaultActivity — Критическая ошибка при работе действия

#Шаблон активити

try < // . code here . > catch( \Throwable $e ) < $this->WriteToTrackingService( sprintf("Error %s on line %s in file %s", $e->getMessage(), $e->getLine(), $e->getFile() ), 0, CBPTrackingType::FaultActivity ); >

#Окружение

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

Представим самый обычный код:

$testMessage = "Entity id: >"; $this->WriteToTrackingService($testMessage);

Код выглядит, запуститься и даже будет выдавать результат, однако в данном случае в нем кроется часовая бомба. В чем проблема? Представим грубо, что любая заменя это просто набор str_replace , т.е. переменные будут заменены как есть. Что произойдет если в заменяемой фразе будет кавычка? Например: в названии компании указано значение ООО «Супер сила»

Читайте также: Java and word document

Таким образом код будет выглядит следующим образом:

$testMessage = "Entity id: ООО "Супер сила""; $this->WriteToTrackingService($testMessage)

Заметили синтаксическую ошибку? Именно — указанный фрагмент будет вызывать фатальную ошибку. Теперь когда вы поняли почему нельзя работать с автозаменой давайте разберем техники как этого обойти.

#Парсинг

Мы уже знаем, что есть парсер который выполняет автозамену, но так же мы знаем что есть и калькулятор выражений, который умеет парсить и обрабатывать значения. За парсинг значений отвечает метод \CBPActivity::parseValue($value, $convertToType = null) , тогда у нас есть возможность использовать ее для своих нужд.

$this->ParseValue('.'=Document:TITLE>')

Правда тут есть одна неприятность: необходимо использовать не отображаемое значение, а реальное. Так например > станет . Тогда > станет .

Таким образом наш преобразованный код будет выглядеть так:

$testMessage = "Entity id: ".$this->ParseValue('.'=Document:TITLE>'); $this->WriteToTrackingService($testMessage);

Почему мы не написали ParseValue(») ? Дело в том, что с таком случае сработала бы автозамена и мы получили такую же ошибку как и ранее, поэтому мы сознательно разделили нашу запись чтобы автозамена значений битрикса не сработала.

#Полезные ссылки

Источник

Действия: Прочее

Variable1 — идентификатор переменной, которой будет присвоено значение (число 12345).

Запись нескольких пользователей в переменную типа «Пользователь»

$this->SetVariable("user", array("user_1", "user_2"));

array(«user_1», «user_2») — массив пользователей в формате

Использование php-кода и значений полей/переменных для получения названия элемента инфоблока

$arFilter = Array("IBLOCK_ID" => , "ID" => ); 
$dc = CIBlockElement::GetList(array(), $arFilter, array("NAME")); 
$br = $dc->Fetch(); 
$Pbrr = $br["NAME"]; 
$this -> SetVariable('Variable2', $Pbrr);

— значение переменной, в которой содержится идентификатор инфоблока;

— поле документа, содержащее идентификатор элемента инфоблока;

Variable2 — идентификатор переменной, которой будет присвоено вычисленное название элемента инфоблока.

Пауза в выполнении

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

Параметры

Промежуток — через какое время бизнес-процесс продолжит выполнение;
Время — конкретный момент возобновления бизнес-процесса.

Если в режиме Время указана прошедшая дата, то процесс просто продолжит свое выполнение и перескочит паузу.

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

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

Блок действий

Блок группирует другие действия для экономии места.

Выбор сотрудника

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

Параметры действия

Тип:случайный — сотрудник выбирается случайным образом. Вам нужно будет заполнить список Из пользователей — из кого будет выбираться сотрудник; начальник — выбор начальника указанного сотрудника. Нужно также будет заполнить опции Для пользователя (чей начальник будет выбран) и Уровень начальника (чем больше, тем выше уровень) — уровень начальника в структуре.
Резервные пользователи — Указываются пользователи, которые будут выбраны в случае невозможности выбора из основных пользователей, указанных выше. Например, если указанная в поле Из пользователей группа не содержит сотрудников, то будет выбран кто-то из резервных пользователей.
Пропускать отсутствующих — позволяет автоматически пропускать отсутствующих сотрудников, например, если они в отпуске.
Пропускать с завершенным рабочим днем — позволяет автоматически пропускать сотрудников, завершивших рабочий день.

Создание группы

Действие создает рабочую группу.

Параметры

Владелец группы — кто будет владельцем группы. Имейте в виду, у группы может быть только один владелец.

Участники группы — укажите членов группы.

Подразделения — можно включить в группу сразу целые отделы.

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

WebHook

Действие добавляет WebHook. Действие не возвращает никаких данных, оно только отправляет запрос. Для коробочных версий доступен только при наличии модуля Rest.

Параметры

Хендлер — URL, который нужно использовать при отправке данных из Битрикс24.

Запись в отчет

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

Параметры

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

Изменение переменных

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

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

Установка прав

Действие устанавливает права на доступ к документу.

Параметры

Право на операцию «. » имеют — установка прав документа для указанных пользователей.

Текущие права документа — что делать с теми правами, что установлены сейчас.

Прерывание процесса

Действие прекращает выполнение бизнес-процесса.

Параметры

Текст статуса — текст статуса действия для лога.

Удалить данные процесса — с помощью этого параметра можно удалить все связанные с бизнес-процессом данные при завершении его работы.

Сгенерировать код

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

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

Параметры

Длина строки — сколько символов будет в итоговом коде.

Алфавит — из каких символов будет состоять код.

Источник