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

calendar.event.update

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

Описание

Редактирует существующее событие.

Возвращаемое значение

Возвращает id отредактированного события.

Параметры

Параметр Описание
* id Идентификатор события.
* type Тип календаря.
* ownerId Идентификатор владельца календаря.
from Дата начала выборки.
to Дата окончания выборки.
from_ts Может быть установлен вместо from.
to_ts Может быть установлен вместо to.
* section Идентификатор раздела.
* name Наименование события.
skip_time [Y|N] Указывает, что значение даты передается без времени.
timezone_from Часовой пояс даты и времени начала события. Значение по умолчанию - таймзона текущего пользователя.
timezone_to Часовой пояс даты и времени окончания события. Значение по умолчанию - таймзона текущего пользователя.
description Описание события.
color Цвет фона события.
text_color Цвет текста события.
accessibility Доступность на время события:
  • busy (занят);
  • absent (отсутствую);
  • quest (под вопросом);
  • free (свободен).
importance Важность события:
  • high (высокая);
  • normal (средняя);
  • low (низкая).
private_event [Y|N] Отметка частного события.
rrule Повторяемость события.
is_meeting [Y|N] Признак встречи с участниками события.
location Место проведения.
remind Напоминание о событии:
  • type - временной тип напоминания (min, hour, day);
  • count - числовое значение временного промежутка.
attendees Список участников события (если is_meeting == "Y").
host Организатор события (если is_meeting == "Y").
meeting Массив параметров, включающий в себя:
  • text - текст приглашения;
  • open - признак открытой встречи;
  • notify - флаг оповещения о подтверждении\отказе участников;
  • reinvite - флаг запроса повторного подтверждения участия (при редактировании события).
* - обязательные параметры

Пример

BX24.callMethod("calendar.event.update",
	{
		id: 699
		type: 'user',
		ownerId: '2',
		name: 'Changed Event Name',
		description: 'New description for event',
		from: '2013-06-17',
		to: '2013-06-17',
		skipTime: 'Y',
		section: 5,
		color: '#9cbe1c',
		text_color: '#283033',
		accessibility: 'free',
		importance: 'normal',
		is_meeting: 'N',
		private_event: 'Y',
		remind: [{type: 'min', count: 10}]
	}
);


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