RSS Reader Обзор
RSS Reader превращает любое количество каналов в один список элементов. В этой статье для редакторов и администраторов объясняется механика этого списка: что такое источник и какие форматы каналов работают, как объединяются и сортируются элементы нескольких каналов, как часто они обновляются и как кэш браузера позволяет веб-части появляться мгновенно. Сами параметры находятся в группах Канал новостей и Поведение панели свойств; шаги настройки описаны в статье KB10367. Как добавить и настроить веб-часть RSS Reader.
Источники
Источник — это канал с тремя атрибутами, которые редактируются в панели Источники группы Канал новостей:
| Поле | Значение |
|---|---|
| URL-адрес | Адрес канала — XML-документа, а не сайта. Обязательное поле. |
| Отображаемое имя | Название источника, которое видят читатели: на его вкладке в ряду источников и в группировке По источнику. Обязательное поле. |
| Порядок | Положение источника среди остальных (1, 2, 3…). Определяет порядок вкладок и групп при сортировке По источнику. |
Ограничения на число источников нет, но каждый источник загружается при каждой загрузке и каждом обновлении, поэтому список из десятка активных каналов появляется дольше и даёт больше элементов, чем может показать ограничение Отображаемые элементы. Практичный диапазон — от трёх до шести источников на веб-часть; большие наборы распределяйте по нескольким веб-частям или страницам.
Адреса источников хранятся в свойствах веб-части, внутри страницы. В Microsoft Teams личное приложение использует набор источников, сохранённый администратором кнопкой Сохранить параметры; у вкладки канала свой набор.
Поддерживаемые форматы каналов и элементы
Каналы загружает и разбирает служба каналов Vitextra, которая возвращает элементы в нормализованном виде (см. Как загружаются каналы ниже). Служба обрабатывает распространённые форматы синдикации — RSS и Atom — и читает расширения, которые издатели используют для более насыщенных элементов:
| Элемент записи | Откуда берётся |
|---|---|
| Заголовок и ссылка | Заголовок и ссылка элемента RSS или Atom |
| Описание | Описание или сводка элемента с удалённой HTML-разметкой |
| Дата публикации | Дата публикации элемента; у элементов без корректной даты дата не показывается |
| Изображение | Media RSS media:content или media:thumbnail, обложка iTunes или первое изображение в HTML-описании (однопиксельные изображения отслеживания пропускаются) |
| Автор | Dublin Core dc:creator, элемент author канала или Media RSS media:credit — в этом порядке |
| Категории | Элементы category записи |
Канал, в котором нет ни одного из расширений, всё равно работает: веб-часть показывает заголовок, описание и дату.
Как загружаются каналы
Скрипт, выполняющийся в браузере, не может загрузить канал с другого сайта, если этот сайт не разрешает междоменные запросы, а издатели каналов почти никогда этого не делают. Поэтому RSS Reader отправляет список адресов источников службе каналов Vitextra, которая загружает каналы из интернета, разбирает их и возвращает каналы и элементы в браузер. Браузер пользователя никогда не подключается к серверам издателей за самим каналом — только за изображениями элементов, которые загружаются напрямую от издателя.
Два следствия для администраторов:
- канал должен быть доступен из интернета: канал на сервере интрасети или за VPN показать нельзя;
- браузерам пользователей нужен доступ к
vitextra.com; запрос содержит адреса источников и те же технические идентификаторы, что и проверка лицензии каждой веб-части Vitextra (см. KB10374. Конфиденциальность и безопасность в RSS Reader: как загружаются каналы и что передаётся).
Источники, которые не удалось загрузить
Если один из источников не удаётся загрузить или разобрать — неверный адрес, сервер не работает, документ оказался веб-страницей, а не каналом, XML повреждён, — служба каналов отмечает его как недоступный и возвращает остальные. Веб-часть при этом:
- исключает недоступный источник из объединённого списка,
- скрывает его вкладку в ряду источников,
- не показывает ошибку — остальные каналы отображаются как обычно.
Источник автоматически появляется снова при следующей загрузке, когда канал опять доступен. Поскольку пропуск происходит молча, редактор, который ошибся в адресе, не увидит предупреждения; единственный признак — отсутствующая вкладка. Чтобы проверить адрес, откройте его в браузере: рабочий канал показывает XML (или отформатированную страницу канала), неверный — сайт или ошибку. Если не работают все источники, веб-часть показывает Элементы не найдены.; если недоступна сама служба каналов — К сожалению, произошла непредвиденная ошибка. Обновите страницу и повторите попытку. См. KB10373. Почему не загружается RSS-канал? Устранение неполадок RSS Reader.
Объединение и сортировка
Элементы всех источников объединяются в один список, а затем сортируются согласно параметру Сортировка группы Поведение:
| Сортировка | Результат |
|---|---|
| Сначала новые (по умолчанию) | Все элементы всех источников по дате публикации, самые свежие наверху |
| Сначала старые | Тот же список в обратном порядке — сначала самые ранние, для хронологий и архивов |
| По источнику | Элементы группируются по источникам в их Порядке; внутри каждой группы — сначала новые |
При сортировке Сначала новые очень активный источник может вытеснить остальные из списка: если один канал публикует двадцать элементов в день, а другой — два в неделю, верх списка займёт активный канал. Три способа сохранить баланс: использовать По источнику, увеличить Отображаемые элементы или включить переключатель Фильтры, чтобы читатели могли выбрать «тихий» источник на его вкладке.
Даты сравниваются как настоящие метки времени. Элементы, для которых канал не даёт корректной даты публикации, считаются самыми старыми: при сортировке Сначала новые они идут последними, при сортировке Сначала старые — первыми, и веб-часть не показывает для них дату.
Выбор читателя — вкладка источника, теги категорий, текст поиска — применяется после сортировки, а ограничение Отображаемые элементы — в последнюю очередь, поэтому веб-часть показывает первые N элементов отфильтрованного отсортированного списка.
Автоматическое обновление
При включённом параметре Автообновление веб-часть перезагружает каналы каждые Периодичность обновления минут (1–7), пока страница открыта. Обновление происходит незаметно: заполнители загрузки не показываются, список заменяется на месте, а текущая вкладка источника, чипы категорий и текст поиска читателя сохраняются. Если обновление не удалось — нет сети, служба каналов недоступна, — веб-часть продолжает показывать уже имеющиеся элементы и пробует снова через следующий интервал.
Отключайте автообновление на страницах, которые люди открывают ненадолго, и включайте на страницах, которые остаются открытыми долго: новостная доска на экране в холле, информационная панель, которую операционная команда держит открытой весь день. Интервал действует на каждую веб-часть отдельно; два RSS Reader на одной странице обновляются независимо.
📝 Заметка
Каждое обновление — это запрос к службе каналов, и служба загружает для него каждый источник. Интервал в одну минуту на странице, которую держат открытой сто человек, означает шесть тысяч запросов каналов в час. Используйте самый короткий интервал только там, где свежесть того стоит, а в остальных случаях — три-пять минут.
Кэш браузера
После каждой успешной загрузки веб-часть сохраняет полученные элементы в хранилище сеанса браузера с ключом по набору адресов источников. Когда та же страница снова открывается в том же сеансе вкладки браузера, веб-часть немедленно показывает элементы из кэша и в фоновом режиме запрашивает свежие; список обновляется, как только они приходят. Кэш используется не более 30 минут, после чего элементы загружаются обычным образом.
Что это означает на практике:
- первое посещение страницы в сеансе браузера показывает заполнители на секунду-другую; последующие посещения показывают содержимое сразу;
- кэш принадлежит сеансу вкладки браузера и исчезает при закрытии вкладки — сверх этого на устройстве ничего не хранится;
- изменение источников делает кэш недействительным, потому что ключ строится из адресов;
- если обновление не удалось, элементы из кэша остаются на экране, а сообщение об ошибке показывается, только когда показывать вообще нечего.
Кэш содержит элементы каналов в том виде, в каком их вернула служба каналов, — заголовки, описания, ссылки, адреса изображений — и никаких персональных данных. На общем компьютере он очищается вместе с остальными данными сайтов сеанса браузера.
