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

bizproc.task.complete

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

Метод осуществляет выполнение заданий БП. В настоящий момент можно выполнить задания Утверждение документа и Ознакомление с документом.

С версии 20.0.800 модуля Бизнес-процессы доступно также выполнение задания Запрос доп.информации. Выполнить можно только свое задание и, только то, которое еще не выполнено.

Параметры

Параметр Описание Примечание С версии
TASK_ID Идентификатор задания, обязательный
STATUS Целевой статус задания, обязательный.
Список допустимых значений:
  • 1 или yes - ответ "Да" (утвержден)
  • 2 или no - ответ "Нет" (отклонен)
  • 3 или ok - ответ "Ок" (ознакомлен)
  • 4 или cancel - ответ "Отмена"
Статусы:
1 и 2 для действия Утверждение документа;
3 и 4 для действия Запрос доп. информации;
3 для действия Запроса доп.информации с отклонением.
COMMENT Комментарий пользователя, обязательность зависит от параметров задания

Пример

function completeTask(id, status, comment, cb)
	{
		var params = {
			TASK_ID: id,
			STATUS: status,
			COMMENT: comment
		};
		BX24.callMethod(
			'bizproc.task.complete',
			params,
			function(result)
			{
				if(result.error())
					alert("Error: " + result.error());
				else if (cb)
					cb();
			}
		);
	}

Выполнение задания Запрос дополнительной информации через REST

С версии 20.0.800 модуля Бизнес-процессы появилась возможность выполнять задания Запрос доп.информации через rest метод bizrpoc.task.complete.

Для того, чтобы понять, какие поля нужно заполнить, в метод bizproc.task.list в PARAMETERS добавлено новое свойство Fields - массив с описанием полей.

"PARAMETERS": {
	"CommentLabel": "Комментарий",
	"CommentRequired": "N",
	"ShowComment": "Y",
	"StatusOkLabel": "Сохранить",
	"Fields": [
		{
			"Type": "datetime",
			"Name": "date",
			"Description": "",
			"Multiple": false,
			"Required": true,
			"Options": null,
			"Settings": null,
			"Default": "2020-07-08T15:16:12+02:00",
			"Id": "date"
		}
	]
}

Значения по умолчанию хранятся в разделе Default. Значения конвертируются во внешнее представление (для дат - в формат rest ATOM (ISO-8601), а для файлов - в ссылку на файл).

Далее значения этих полей нужно передать в метод bizrpoc.task.complete в параметре Fields. Значения конвертируются в этот раз во внутреннее представление (т.е. даты из rest формата конвертируются во внутренний, а файлы из rest сохраняются и прикрепляются к бизнес-процессу).



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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Эльяр Арзыкаев
Сообщение не промодерировано, возможны ошибки и неточности.
Никакой возможности переадресовывать задания, подскажите, нет документации или вообще такой функции не существует в АПИ?
0
Денис Максимов
Выполнение задания Запрос дополнительной информации через REST - версия для PHP:
Код
<?
    require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
    require($_SERVER["DOCUMENT_ROOT"]."/local/test6/in_hook/crest.php");    
    
    $ID=7; // ID Задания бизнес-процессов для проверки службой безопасности
    $STATUS=3; // или ok - ответ "Ок" (ознакомлен)
    $comment="Комментарий пользователя"; //Комментарий пользователя, обязательность зависит от параметров задания
    
    //Запрос дополнительной информации
    $params = array(    
    "TASK_ID" => $ID,
    "STATUS" => $STATUS,
    "COMMENT" => $comment,   
    
    "FIELDS" => [
    "ID_business_process" => "Значение Бизнес-процесс",  // ID_business_process - ID поля (он же идентификатор переменной из БП)
    "sat_response" => "Значение Бизнес-процесс sat_response", // sat_response - ID поля (он же идентификатор переменной из БП)
    "sat_comment" => "Значение Бизнес-процесс sat_comment", // sat_comment - ID поля (он же идентификатор переменной из БП)
    ],    
    ); //end $params = array(
    
    $result = CRest::call(
    'bizproc.task.complete',
    $params
    );
    
echo "<pre>Template arParams: "; print_r($result); echo "</pre>";
© «Битрикс», 2001-2024, «1С-Битрикс», 2024