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

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