Перейти к содержанию

FAQ: CalDav (Яндекс и др.) — HTML-теги в описании событий

FAQ для поддержки по проблеме отображения HTML-тегов в описании событий при синхронизации 1Формы со сторонними календарями через CalDav. Документ объясняет техническую причину (хранение описания в HTML, экспорт в ICS без конвертации в обычный текст), содержит готовый ответ пользователю и обходные решения.

1. Симптомы и техническая причина

Пользователь жалуется на отображение HTML-тегов в стороннем календаре:

  • «В Яндекс.Календаре в описании события видны HTML-теги (<p>, <br>, <b>)»
  • «При синхронизации через CalDav описание превращается в нечитаемый HTML-код»
  • «В 1Форме описание красиво, а в стороннем календаре — с тегами»

Техническая причина:

  1. В 1Форме описание события хранится в формате HTML (BodyType = HTML)
  2. При экспорте через CalDav/ICS описание записывается в поле DESCRIPTION без конвертации HTML → текст
  3. По стандарту RFC 5545 поле DESCRIPTION — это обычный текст (без форматирования)
  4. Сторонние календари (Яндекс, Google, Apple) интерпретируют содержимое DESCRIPTION как обычный текст → HTML-теги отображаются «как есть»

При экспорте описание переносится в поле DESCRIPTION без какой-либо обработки HTML — выполняется только обрезка пробелов и экранирование переноса строки.

Exchange — исключение: провайдер Exchange выполняет внутреннюю очистку HTML-обёрток для обмена с Exchange, но это не конвертация в обычный текст для ICS.

2. Ответ пользователю, обходные решения и обращение в поддержку

Готовый ответ пользователю:

Это известное ограничение: при синхронизации через CalDav описание события передаётся в формате, который сторонние календари (Яндекс, Google) показывают с HTML-тегами. Формат CalDav (ICS/RFC 5545) не поддерживает форматированный текст в поле Description.

Для корректного отображения рекомендуется использовать текстовые описания без форматирования, либо Exchange-интеграцию (которая обрабатывает HTML отдельно).

Обходные решения:

Решение Применимость
Использовать Exchange вместо CalDav Если инфраструктура поддерживает Exchange
Не использовать HTML-форматирование в описании встречи Если допустимо для бизнеса
Ожидать доработку (конвертация HTML → обычный текст при экспорте в ICS) Возможная задача на доработку

Что запросить у пользователя:

  • Скриншот описания в 1Форме и в стороннем календаре
  • Название стороннего календаря (Яндекс, Google, Apple, Thunderbird)
  • ID встречи/события

Когда обращаться в поддержку 1Ф:

  • Если описание повреждено (не просто теги, а потеря данных) — обратиться в поддержку 1Ф
  • Если нужна доработка (очистка HTML при экспорте в CalDav) — оформить задачу на доработку

Связанные документы: