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 сохраняются и прикрепляются к бизнес-процессу).