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

bizproc.workflow.start

Scope: bizproc Права на выполнение: для всех

bizproc.workflow.start – метод запускает Бизнес-процесс.

Для запуска БП из ленты новостей используйте метод lists_element_add. IBLOCK_TYPE_ID в этом случае будет bitrix_processes.

Параметры

Параметр Описание
TEMPLATE_ID Идентификатор шаблона БП
DOCUMENT_ID Идентификатор документа БП
PARAMETERS Значения параметров БП (если шаблон с параметрами)

Примеры

function startWf(leadId, tplId, cb)
{
	if (!leadId)
	{
		alert('Lead not selected');
		return;
	}
	var params = {
		TEMPLATE_ID: tplId,
		DOCUMENT_ID: ['crm', 'CCrmDocumentLead', leadId],
		PARAMETERS: null
	};

	BX24.callMethod(
		'bizproc.workflow.start',
		params,
		function(result)
		{
			if(result.error())
			alert("Error: " + result.error());
			else if (cb)
				cb();
		}
	);
}

Примеры подстановки в параметр DOCUMENT_ID:

['crm', 'CCrmDocumentLead', 'LEAD_777'] – Лид
['crm', 'CCrmDocumentCompany', 'COMPANY_777'] – Компания
['crm', 'CCrmDocumentContact', 'CONTACT_777'] – Контакт
['crm', 'CCrmDocumentDeal', 'DEAL_777'] – Сделка
['disk', 'Bitrix\Disk\BizProcDocument', '777'] – файл Диска
['lists', 'BizprocDocument', '777'] – документ Процессов в ленте (в новостях)
['lists', 'Bitrix\Lists\BizprocDocumentLists', '777'] – документ Списков

Пример DOCUMENT_ID для смарт-процесса:

DOCUMENT_ID = ['crm', 'Bitrix\Crm\Integration\BizProc\Document\Dynamic', 'DYNAMIC_147_1']

Где 147 – это ID смарт-процесса, 1 – ID элемента.


Пример подстановки в параметр DOCUMENT_ID для новых счетов:

Bitrix\Crm\Integration\BizProc\Document\SmartInvoice

SMART_INVOICE_<ID элемента> 

Для передачи в PARAMETERS параметра типа «Привязка к пользователю» используйте запись идентификатора пользователя в виде user_ID. Например:

PARAMETERS: {
	'resp_employee': user_14 // ID сотрудника
}


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

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Константин Савин
Сообщение не промодерировано, возможны ошибки и неточности.
executeREST('bizproc.workflow.start', [
   'TEMPLATE_ID' => 598, //номер БП можно взять из строки адресной
   'DOCUMENT_ID' => array('crm','CCrmDocumentDeal',1111), // номер сделки
   'PARAMETERS' => array('Parameter1'=>1111)// номер сделки
]);
0
Сергей Сагин
Сообщение не промодерировано, возможны ошибки и неточности.
Для создания бп в ленте новостей и что бы он появился в автоматизации действительно нужно использовать метод lists_element_add. IBLOCK_ID я нашел в инструментах разработчика. Как нашел: зашел в бп в ленте новостей выбрал нужный бп у меня это был ТЕСТ, далее нажал кнопку добавить и создать бп. В вкладке network в инструментах разработчика увидел запрос и в адресе запроса указан наш IBLOCK_ID  /processes/85/. 'ELEMENT_CODE': 'bitr_2', тут можно указать рандомное значение но оно должно быть уникально по отношению к этому бп. И указал 'FIELDS': { 'NAME': 'тест',} так как запрос тоже отправляет это поле. Это поле нельзя удалить в бп и оно является полем по умолчанию.
2
Greu
Сообщение не промодерировано, возможны ошибки и неточности.
Достало уже вашу чушь перечитывать когда надо сделать веб запрос get post в одну строку это всегда 2-4 часа времени


Сделайте для всех методов веб запросы с примерами!!!! достала ваша дока кривая
1
Greu
Сообщение не промодерировано, возможны ошибки и неточности.
Сделайте нормальное описание составления запросов в одну строку для POST, GET. По несколько часов уходит чтобы простой запрос составить, документацию похоже составляли а бы как, лишь бы что то было. :!:  
3
Владимир Макаров
Сообщение не промодерировано, возможны ошибки и неточности.
Благословляю вас четким кодом для запуска в Смартах - легко переделать под что вам нужно вот пример на php Благодарите и еще раз благодарите = )))))))
function StartBPB24TaskACT($allElementActInAgreement, $name_project_crm) {

   foreach ($allElementActInAgreement as $id => $element) {
   // url стартовый поменяйте
   $baseURL = 'https://Адреспортала/rest/879/СпасибоVakaram=)zproc.workflow.start/?';
   $params = array(
       'TEMPLATE_ID' => 309,// id бп который хотите запуустить
       'DOCUMENT_ID[0]' => 'crm',
       'DOCUMENT_ID[1]' => 'Bitrix\Crm\Integration\BizProc\Document\Dynamic',
       'DOCUMENT_ID[2]' => "DYNAMIC_147_" . $element['id_act'], //147 номер для Смарта(смотреть в url у себя)  //_и далее это id акта
       'PARAMETERS' => array('nameProjectCRM' => $name_project_crm),
   );

   // Инициализация cURL-сессии
   $ch = curl_init();

   // Установка опций cURL
   curl_setopt($ch, CURLOPT_URL, $baseURL);
   curl_setopt($ch, CURLOPT_POST, 1);
   curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));

   // Передача параметров POST-запроса
   curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded'));

   // Выполнение запроса
   $response = curl_exec($ch);

   // Обработка результата
   if ($response === false) {
       echo 'Error: ' . curl_error($ch);
   } else {
       $result = json_decode($response, true);
       if (isset($result['error'])) {
           echo 'Error: ' . $result['error'];
       }
       }
   }

   curl_close($ch);
}
4
Надежда Каракулина
Сообщение не промодерировано, возможны ошибки и неточности.
Пример для вебхука
Хук.bmp (939.31 КБ)
8
Владимир Макаров
Сообщение не промодерировано, возможны ошибки и неточности.
Ой да когда же вы доку почините и нормальную сделаете ? А ? А ? Достали уже каждый раз когда надо вот вашу чушь переписать в веб запрос get post в одну строку это всегда 2-4 часа времени
И вот даже два следа обратных между ссылок вызывают смех!!!
До сих пор в доке не поправили, правильно зачем нужно да ! ?


Сделайте для всех методов веб запросы с примерами!!!! достала ваша дока кривая
4
a@forbiz.tech
Цитата
пишет:
Может у кого то возникнет такая же проблема как и у меня. Писал тех поддержке, никак не смогли помочь, в итоге методом тыка сам смог найти решение.
Суть была запустить БП из списка "['lists', 'Bitrix\Lists\BizprocDocumentLists', '777']" не работал и выдавал ошибку "Error: : Incorrect document type! (400)"
Решение как оказалось очевидно, добавить еще один слэш  "\". В итоге код выглядит вот так "['lists', 'Bitrix\\Lists\\BizprocDocumentLists', '777']" и все прекрасно работает
в смарт процессах такая же история.  итоговый код "Bitrix\\Crm\\Integration\\BizProc\\Document\\Dynamic"
0
Кирилл Бажинов
Всем кто пытался загрузить файл в параметр бизнес-процесса - на момент написания комментария сделать это нельзя!!!

Ответ от тех поддержки:
На данный момент возможность передачи файла в параметр бизнес-процесса в методе bizproc.workflow.start не реализована. Но в разработке уже есть заявка на данную доработку.
6
Айдос Отынбай
Может у кого то возникнет такая же проблема как и у меня. Писал тех поддержке, никак не смогли помочь, в итоге методом тыка сам смог найти решение.
Суть была запустить БП из списка "['lists', 'Bitrix\Lists\BizprocDocumentLists', '777']" не работал и выдавал ошибку "Error: : Incorrect document type! (400)"
Решение как оказалось очевидно, добавить еще один слэш  "\". В итоге код выглядит вот так "['lists', 'Bitrix\\Lists\\BizprocDocumentLists', '777']" и все прекрасно работает
© «Битрикс», 2001-2024, «1С-Битрикс», 2024