Документация для разработчиков
Темная тема

CBPActivity

Описание

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

Действие — это класс, который наследуется от абстрактного класса CBPActivity или его потомков. Название класса должно начинаться с подстроки "CBP" и может состоять из латинских букв и цифр.

<?
if (!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();

class CBPMyActivity1
extends CBPActivity
{
. . .
}
?>

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

Составные действия наследуются от абстрактного класса CBPCompositeActivity, который в свою очередь наследуется от класса CBPActivity. Класс CBPCompositeActivity обеспечивает поддержку возможности включать внутрь действия дочерние действия. Например, составным действием является стандартное действие CBPParallelActivity (параллельное выполнение), которое содержит в себе дочерние действия, соответствующие веткам параллельного выполнения.

Класс CBPCompositeActivity содержит член arActivities, с помощью которого можно обращаться к дочерним действиям.

Класс CBPActivity содержит следующие члены, которые можно применять в действиях-наследниках:

  • workflow – содержит объект-оболочку типа CBPWorkflow для данного бизнес-процесса,
  • parent – содержит родительское действие,
  • executionStatus – статус выполнения действия,
  • executionResult – результат выполнения действия.

Список методов

МетодОписаниеС версии
ExecuteЭтот метод вызывается исполняющей средой при выполнении действия. Он непосредственно реализует поведение действия и должен быть переопределен в каждом действии.
InitializeЭтот метод вызывается исполняющей средой для инициализации действия, которая происходит до запуска бизнес-процесса на выполнение. Большинство действий не переопределяют этот метод.
HandleFaultЭтот метод вызывается исполняющей средой при возникновении ошибки выполнения действия. Метод может быть переопределен, если при возникновении ошибки выполнения действия необходимо выполнить какой-либо код.
AddStatusChangeHandlerМетод добавляет новый обработчик события изменения статуса действия.
GetNameМетод возвращает имя действия. Имя действия уникально в рамках бизнес-процесса.
GetRootActivityМетод возвращает корневое действие бизнес-процесса. Корневое действие реализует интерфейс IBPRootActivity.
GetWorkflowInstanceIdМетод возвращает код бизнес-процесса.
RemoveStatusChangeHandlerМетод удаляет обработчик события изменения статуса действия.
WriteToTrackingServiceМетод записывает в лог произвольное сообщение. Кроме того может быть записано, от имени какого пользователя отправляется это сообщение.

Пример

<?
// Код класса действия, которое создаст файл с указанным в свойствах действия именем
class CBPMyActivity
extends CBPActivity
{
public function __construct($name)
{
parent::__construct($name);
// Определим свойство FileName, в котором будет содержаться имя файла
$this->arProperties = array("Title" => "", "FileName" => "");
}

// Исполняемый метод действия
public function Execute()
{
// Если свойство с именем файла задано, осуществим в него запись
// Обратите внимание, что для упрощения кода здесь не добавлены
// необходимые проверки безопасности
if (strlen($this->FileName) > 0)
{
$f = fopen($this->FileName, "w");
fwrite($f, "Какой-то текст");
fclose($f);
}

// Вернем указание исполняющей среде, что действие завершено
return CBPActivityExecutionStatus::Closed;
}
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024