Поиск событий

Элемент находит события в календаре пользователя за указанный период и по тексту либо получает событие по идентификатору. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

Свойство	Тип	Описание
Аккаунт:
E-Mail	String	Адрес пользователя, в календаре которого выполняется поиск. См. Свойство E-Mail
Календарь	Calendar	Календарь для поиска. Если не заполнено — поиск по всем событиям пользователя
Параметры:
Повторяющиеся	Boolean	Включать в результат повторяющиеся события. По умолчанию выключено
Дата начала	DateTime	Искать события, начинающиеся не ранее указанного момента (UTC)
Дата окончания	DateTime	Искать события, заканчивающиеся не позднее указанного момента (UTC)
ID	String	Идентификатор события. Если заполнено, остальные параметры поиска не учитываются
Кол-во	Int32	Максимальное количество событий. По умолчанию `50`
Фильтр	String	Текст для поиска в теме, описании, адресах участников и месте проведения. Регистр букв учитывается
Результат:
События	List<Event>	Переменная для сохранения найденных событий

Примечание: Дата начала и Дата окончания сравниваются со временем событий в UTC. Для поиска по местному времени переводите значения: DateTime.Today.ToUniversalTime().

Примечание: Для повторяющегося события возвращается одна запись — описание серии, а не отдельные ее вхождения.

Практические примеры

Пример 1: события на сегодня

E-Mail: "robot@company.ru"
Дата начала: DateTime.Today.ToUniversalTime()
Дата окончания: DateTime.Today.AddDays(1).ToUniversalTime()
События: events

Пример 2: поиск встреч по теме за месяц

Дата начала: DateTime.Today.AddDays(-30).ToUniversalTime()
Фильтр: "Сверка"
Кол-во: 100
События: events

Пример 3: событие по сохраненному идентификатору

ID: savedEventId
События: events — искомое событие будет events[0]

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

Ошибка	Причина и решение
`Access is denied`	Не заполнен E-Mail при входе от имени приложения или не выдано разрешение `Calendars.Read`
`ErrorItemNotFound`	Событие с указанным ID не найдено в календаре пользователя