Все ноды/Integrations/Calendar

Календарь: все календари

Список коллекций календарей для подключённого аккаунта CalDAV.

Календарь: все календари▶
Подключение CalDAVКалендари
Ошибка

Тип в графе: calendar_list_calendars

Exec

Можно включить выход ошибки и обработать сбой отдельным путём.

Порты можно разделить на исполнение и данные (split ports).

Как попробовать

Минимальный рабочий сценарий

Вход
Календарь: все календари▶
Календарь: подключение CalDAV
Выход▶
  • Исполнение
  • Данные
  • Исполнение + данные
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.

Как применять

Разведочная нода: показывает, какие коллекции календарей есть у аккаунта, и главное — их URL, которые дальше подставляются во все остальные календарные ноды. Держать её в рабочем графе обычно незачем: адрес коллекции стабилен, его достаточно посмотреть один раз и вписать в поля или в «URL календаря по умолчанию» самой интеграции.

Как это работает

Нода находит домашний каталог календарей аккаунта и перечисляет коллекции в нём. Собственных настроек, кроме подключения, у неё нет — всё решает режим обнаружения, заданный в интеграции CalDAV.

В режиме «Автоматически» нода спрашивает у сервера, кому принадлежат учётные данные, и где лежат его календари, при неудаче пробуя стандартный адрес .well-known/caldav. Если в подключении выбрано «Указать URL календаря вручную», нода вообще не ходит за списком: она возвращает ровно один элемент — этот самый URL, с пустым названием.

На выходе calendars: у каждой записи href, display_name и color (может быть null).

Частые ошибки

  • Один элемент вместо всех. Это не пустой аккаунт, а режим «Указать URL календаря вручную» в интеграции. Переключите его на «Автоматически», если нужен полный список.
  • Пустое display_name. Название — необязательное свойство коллекции; ориентируйтесь на href, а не на подпись.
  • «Could not discover current-user-principal». Код PROVIDER_ERROR с таким текстом почти всегда означает неверный базовый URL подключения. Лечится либо исправлением адреса, либо режимом «Указать календарь-хоум вручную» с заполненным URL домашнего календаря.
  • Список обрезается на 500 коллекциях. Для обычного аккаунта потолок недостижим, но знать о нём стоит.
  • Вызов на каждом ходу чата. Обнаружение — это два-три запроса к серверу ради ответа, который почти никогда не меняется. Лучше один раз записать URL в конфигурацию.

Входы

ПортПроводДанныеПримечания
Подключение CalDAVcalendar_storeДанныеdata—

обязателен

Выходы

ПортПроводДанныеПримечания
КалендариoutputИсполнение + данныеexecute_dataobject
Ошибкаon_errorИсполнение + данныеexecute_data—

показывается, когда expose_error_output = true

Настройки

ПолеТипПо умолчаниюОписание
Подключение CalDAVconnection_idstring""

Сохранённое подключение CalDAV из пространства: простому календарному сценарию не нужна отдельная нода «Календарь: подключение CalDAV». Нода, подключённая к порту «Подключение CalDAV», имеет приоритет над этим полем.

подключение: caldavперекрывается портом: calendar_store

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

  • expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этой ноды.
  • split_ports_in — Показывать отдельные порты входа для выполнения и данных вместо одного объединённого.
  • split_ports_out — Показывать отдельные порты выхода для выполнения и данных вместо одного объединённого.