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

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

Начальные требования

Необходимый минимум знаний для изучения курса:

У нас часто спрашивают, сколько нужно заплатить

Но у нас есть Академия 1С-Битрикс, где можно обучиться на платной основе на курсах нашей компании либо наших партнёров.

Тесты и сертификат

После изучения курса вам будет предложено пройти тесты на сертификацию. При успешной сдаче последовательности тестов на странице Моё обучение можно просмотреть результат обучения и загрузить сертификат в формате PDF.

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

Для преподавания оффлайн

Если данный курс берётся в качестве основы для оффлайного преподавания, то рекомендуемая продолжительность: 4 дня (32 академических часа).

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

Скачать материалы курса в формате 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

Как проходить учебный курс?

Источник

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

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

Курс предусматривает обучение по двум ролям администраторов: Администратор корпоративного портала и Администратор системы.

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

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

Начальные требования

Для прохождения курса необходимо:

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

Администратору системы будет полезно ознакомиться с курсом Разработчик Bitrix Framework, рассказывающем о принципах работы Bitrix Framework.

Тесты и сертификат

После изучения курса вам будет предложено пройти тесты на сертификацию. При успешной сдаче линейки тестов на странице Моё обучение можно просмотреть результат обучения и загрузить сертификат в формате PDF.

Для преподавания оффлайн

Если данный курс берётся в качестве основы для оффлайного преподавания, то рекомендуемая продолжительность: 10 дней (70 академических часов).

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

Скачать материалы курса в формате 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

Источник

Бизнес-процессы переменные в php коде

да и как узнать SID переменной? Или SID это ее идентификатор?

Большое спасибо с переменными разобрался.

А как получить параметры запрашиваемые в начале бизнес процесса?

Да и как получить комментарий который указывается в форме запроса?

дело в том что у меня два параллельных процесса
1. запрашивает данные у клиента
2. запрашивает данные у админа но и также спрашивает перейти ли процессу на следующий статус.

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

В итоге когда админ говорит перейти на следующий статус, то процесс не идет дальше пока клиент не введет данные в форму.

Источник

Бизнес-процесс по своей сущности в коробочном Битрикс24

Привет!
Продолжаем учиться правильно кастомизировать Битрикс24

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

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

[spoiler]
Общие сведения

Модуль БП спроектирован таким образом, чтобы была возможность запускать бизнес-процессы по разным сущностям системы, даже тем, которые появятся в будущем. Чтобы достичь этой универсальности, были введены абстракции «тип документа» и «документ».

Бизнес-процесс не может выполняться без документа. Однако в самом модуле БП, «тип документа» и «документ» — абстрактные понятия, физический смысл которых не определен. Конкретные реализации предоставляют модули, которые интегрированы с БП. Например, в модуле инфоблоков, типом документа является инфоблок, а документом — элемент инфоблока; в универсальных списках — аналогично; в CRM типы документов — лид, сделка, контакт…, документы — конкретные лиды, сделки, контакты.

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

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

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

Поскольку модуль БП может работать с разными сущностями, ему необходимо отличать «определения» документа и типа документа для разных модулей. Поэтому модуль БП использует комплексные идентификаторы.

Представление на языке PHP — последовательный массив из трех элементов, например, так представлен стандартный универсальный список «Клиенты»:

Представление на языке PHP — последовательный массив из трех элементов, например, так представлен элемент стандартного универсального списка «Клиенты»:

В данном случае в качестве непосредственного идентификатора документа I использовано число. Модуль БП не ограничивает нас числовым типом данных. Например, модуль CRM использует идентификаторы вроде DEAL_51. В этом же виде идентификатор будет передан в методы класса документа.

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

Интеграция с бизнес-процессами

На уровне API

Приступим к интеграции. Начнем с класса документа, так как без него не будет работать все остальное.

Класс документа будет называться \Academy\CrmStores\BizProc\StoreDocument. Он должен реализовывать интерфейс \IBPWorkflowDocument. Этот интерфейс потребует реализовать немало методов, но сначала несколько оговорок.

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

Во-вторых, в интерфейсе IBPWorkflowDocument отсутствуют некоторые методы, необходимые для корректной работы БП. Один из таких методов — GetDocumentType.

Теперь приступим к реализации методов.

Метод должен возвращать код типа документа для документа с указанным идентификатором. Идентификатор документа не комплексный.

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

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

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

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

Аргументы те же, что и у метода CanUserOperateDocument, кроме:

Метод должен вернуть true, если выполнение операции разрешено, false — в противном случае.

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

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

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

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

Генерирует комплексный идентификатор документа.

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

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

Данный метод выполняет преобразование, обратное тому, что делает convertStoreToBp.

Вернемся к реализации методов интерфейса IBPWorkflowDocument.

Метод должен возвращать значения тех полей, которые заявлены в методе GetDocumentFields. Идентификатор документа — не комплексный.

Изменяет значений полей документа. Используется действием «Изменение документа». Идентификатор — не комплексный.

Удаляет документ с указанным идентификатором. Идентификатор — не комплексный.

Метод должен возвращать URL страницы управления документом.

В нашем случае вернем ссылку на карточку торговой точки, аналогично CRM. URL генерируется из шаблона, который задан в настройках модуля.

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

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

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

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

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

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

Эти методы используются действиями «Публикация документа» и «Снятие документа с публикации». Если понятие публикации не применимо к вашему документу, можно не реализовывать эти методы.

Например, для элементов инфоблоков это понятие определено. Считается, что в публичной части появляются только те элементы, которые опубликованы.

Другой пример: в CRM нет разделения на публичный и административный интерфейс для работы с лидами, сделками и т. д. Элементы CRM не могут быть опубликованы, поэтому данные методы не реализованы.

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

LockDocument
UnlockDocument
IsDocumentLocked

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

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

Если вы решили оставить эти методы без реализации, то IsDocumentLocked должен возвращать false (в противном случае, БП «зависнет»), а остальные — true.

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

Права БП и их отображение на права доступа к документу — непростая тема, которую в данной статье затрагивать не будем.

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

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

Конструктор шаблонов БП

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

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

В class.php компонента stores.

Страница списка шаблонов БП

Рассмотрим страницу списка шаблонов БП (bizproc_workflow_admin.php). В самом начале вызывается компонент верхнего меню CRM (crm.control_panel) и добавляется ссылка для возврата к списку. Мы уже рассматривали их в предыдущих статьях.

Далее мы вызываем два компонента — панель инструментов с кнопками создания нового шаблона (со статусами и последовательного) и непосредственно список шаблонов.

Ссылки строятся на основе настроек ЧПУ (обе ведут на страницу конструктора). В ссылку на создание БП со статусами добавлен GET-параметр init=statemachine, который используется компонентом конструктора и указывает тип шаблона.

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

Теперь, если перейти на эту страницу, можно увидеть следующее.

После создания шаблонов, они будут появляться в этом списке.

Страница конструктора шаблонов БП

На странице конструктора вызовем компонент bizproc.workflow.edit.

Первые три параметра компонента — комплексный идентификатор типа документа. ID — идентификатор редактируемого шаблона, если 0 — создание нового. Шаблоны ссылок взяты из настроек ЧПУ.

На этом подключение конструктора БП завершено.

Создадим тестовый БП, который будем использовать далее для отладки запуска. БП состоит из одного действия — «Уведомление пользователя», которое отправляет уведомление с названием торговой точки (если поля документа описаны правильно в методе GetDocumentFields, вы будете видеть их в окне вставки значения). У этого шаблона БП установлен флаг «Автоматически запускать при добавлении».

Устоявшаяся практика — запускать БП только если причиной добавления или изменения документа являются соответствующие действия пользователя. То есть, например, при создании документа через API (StoreTable::add) запуск БП происходить не должен. Вы можете это проверить на любой сущности системы.

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

Наконец, модифицируем метод executeComponent, в котором вызовем startBp.

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

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

Необходимо добавить запуск БП в два метода документа — CreateDocument и UpdateDocument.

Больше изменений в классе документа не будет.

Компоненты БП будем вызывать в компоненте карточки торговой точки (store.show), а полученный HTML-код передавать в шаблон.

Начнем с добавления вкладки в шаблоне карточки торговой точки.

Когда GET-параметров нет, запускается метод getWorkflowListHtml. Он вызывает компонент bizproc.document, который выводит список запущенных БП, а также несколько ссылок.

Первые 4 параметра образуют комплексные идентификаторы документа и типа документа.

Параметр #ID# используется компонентом bizproc.document, он будет заменен на настоящий идентификатор.

При вызове этого компонента вы должны увидеть следующее.

При переходе по ссылке «Запустить новый бизнес-процесс», GET-параметр bizproc_start будет равен Y, в этом случае запустим другой компонент.

Компонент bizproc.workflow.start выводит список шаблонов, которые можно запустить, а также (при необходимости) выводит форму для задания значений параметров шаблона. Параметр запроса workflow_template_id компонент добавит сам, нам нужно лишь передать его значение обратно в компонент.

Теперь при переходе по ссылке «Запустить новый бизнес-процесс» можно увидеть список. При клике по названию шаблона БП запускается.

Если задано значение GET-параметра bizproc_log, запустим компонент bizproc.log, который выводит журнал выполнения БП.

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

Когда задано значение GET-параметра bizproc_task, запустим компонент bizproc.task, который выводит форму задания БП.

Чтобы проверить работу этого компонента, а также задание значений параметров при запуске, создадим еще один шаблон БП.

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

Запустим БП из карточки CRM.

Компонент bizproc.workflow.start перед непосредственно запуском просит задать значения параметров.

В списке БП видно, что поставлено задание.

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

Обратите внимание, что задания также появляются в разделе «Бизнес-процессы» (см. меню слева).

Запуск БП из списка

В интерфейсе CRM также предусмотрен запуск БП из списка (контекстное меню строки). Например:

Для реализации этого способа запуска будем использовать библиотеку bp_starter. Для запуска БП достаточно вызвать один метод: BX.Bizproc.Starter.singleStart.

Пункты меню формируются в шаблоне компонента списка (stores.list). Воспользуемся методом CBPDocument::GetWorkflowTemplatesForDocumentType, чтобы получить список шаблонов БП и передадим этот список в шаблон. На вход метод принимает комплексный идентификатор типа документа.

Подключим библиотеку bp_starter с помощью класса CJSCore.

Сформируем пункты меню для запуска БП.

Метод BX.Bizproc.Starter.singleStart принимает на вход два аргумента — параметры БП и callback-функцию, которая будет вызвана после запуска БП.

Параметры запуска — JS-объект, включающий комплексные идентификаторы документа и типа документа, а также некоторые параметры шаблона БП, которые были получены ранее.

В качестве callback-функции мы вызываем BX.Main.gridManager.reload, которая обновляет грид без перезагрузки страницы. Обновление необходимо, т. к. БП мог внести изменения в существующие торговые точки, создать или удалить новые и т. п. Вам также это может понадобиться, если вы выводите состояние БП и ссылки на задания в списке (как это уже сделано в сделках).

Чтобы сделать пункт меню с вложенным меню, вместо ONCLICK передаем массив дочерних пунктов меню с ключем MENU.

Об удалении документа

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

Самый удобный способ это сделать — определить метод onAfterDelete в классе сущности (StoreTable).

Чтобы убедиться, что БП действительно удаляются, проверьте таблицу b_bp_workflow_state. Столбцы MODULE_ID, ENTITY, DOCUMENT_ID образуют комплексный идентификатор документа.
Установщик модуля
Процесс установки модуля почти не изменился. Мы лишь добавили три служебных скрипта для конструктора, которые устанавливаются в каталог /bitrix/admin.

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

Аргументы метода:

Разумеется, шаблон сначала нужно экспортировать из конструктора.

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

Заключение

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

Источник