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

timeman.timecontrol.report.add

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

Описание и параметры

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

Параметры

ПараметрПримерОбязательныйОписание
ID 468 Да Идентификатор записи.
TYPE work Да Тип отсутствия (work - по рабочим вопросам, private - личные дела).
TEXT 'Был на обеде' Да Описание причины отсутствия.
CALENDAR true Нет Занести отсутствие в календарь (только для первичного отчета).
USER_ID 2 Нет Идентификатор пользователя для которого сформирован отчет (поле доступно только администраторам).

Пример вызова

JavaScript

BX24.callMethod('timeman.timecontrol.report.add', {
	'id': 468,
	'type': 'private',
	'text': 'Был на обеде',
	'calendar': true
}, function(result){
	if(result.error())
	{
		console.error(result.error().ex);
	}
	else
	{
		console.log(result.data());
	}
});

PHP

$result = restCommand('timeman.timecontrol.report.add', Array(
	'ID' => 468,
	'TYPE' => 'private',
	'TEXT' => 'Был на обеде',
	'CALENDAR' => true
), $_REQUEST["auth"]);	

Пример ответа

{    
	"result": true
}

Пример ответа при возникновении ошибки

{
	"error": "TEXT_EMPTY",
	"error_description": "Text can't be empty"
}
  • Ключ error - код возникшей ошибки.
  • Ключ error_description - краткое описание возникшей ошибки.

Возможные коды ошибок

КодОписание
TEXT_EMPTYНе передана причина отсутствия.
ACCESS_ERRORУ вас нет доступа к этому отчету.


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