RSS интеграция

Техническа справка

Как работи синхронизацията

1. Сървърът изтегля настроената RSS емисия и сравнява идентификаторите на елементите и стойностите на changeDate със съхранените записи.
2. Новите и променените елементи се обработват. Сървърът изтегля медийните им файлове и ги изпраща към файловата услуга за съхранение и необходимото преобразуване; неизползваните елементи и медийни файлове се почистват.
3. Сървърът уведомява портала за открита промяна. След това порталът организира доставянето на актуализираните данни до устройствата, които използват този канал.
4. Всяко устройство записва получените данни и изтегля необходимите прикачени файлове отделно. Получаването на дефиниция само по себе си не потвърждава, че изтеглянето на всички медийни файлове е приключило.

Вижте настройка на RSS приложение за интервала на проверка на емисията и задаването на приложението. Актуализациите не са незабавни: подготовката на медийните файлове и свързаността на устройството също влияят на доставянето.

Описаната тук синхронизация предполага емисия с поне един валиден елемент. Не разчитайте, че изпразването на емисията гарантира спиране на показването на съдържанието ѝ.

Как системата открива промени в елементите

• Идентификатор guid в новата дефиниция, който липсва в старата → нов елемент; медийните му файлове се изтеглят и подготвят.
• Предишен guid липсва в новата дефиниция → премахнат елемент; медийните му файлове се премахват.
• Идентификаторът guid съществува и в двете, но changeDate е различен → променен елемент; старите медийни файлове се премахват, а новите се изтеглят и подготвят.

При промяна на заглавие, описание, връзка или прикачен файл запазете guid и променете changeDate. Това се отнася и за замяна на файл на непроменен URL адрес. Самото пренареждане на елементите може да не задейства доставянето на нова дефиниция; актуализирайте и changeDate, за да бъде доставена промяната.

Основни свойства

• guid: Уникален, постоянен идентификатор на елемент, например идентификатор на запис в база данни. Запазвайте го при редактиране на съдържанието.
• title: Задължително, непразно заглавие. HTML тагове се приемат, но списъкът и заглавието в подробния изглед показват обикновен текст.
• description: Описание на елемента. Може да съдържа HTML; форматираното показване зависи от настройките на RSS приложението.
• category: Име на категория, използвано за филтриране. Селекторът за категории се показва, когато каналът има поне една непразна категория.
• link: Абсолютният URL адрес на свързана уеб страница. Връзка, започваща с http, се показва и като QR код в подробностите за елемента за използване на мобилно устройство.
• pubDate: Датата и часът на създаване на елемента. Това не планира публикуването му: бъдеща дата не пречи елементът да се показва.
• endDate: Крайната дата и час на валидност на елемента. Задаването на това поле не гарантира незабавно скриване според часовника на устройството, особено когато то е офлайн. Не разчитайте само на него за съдържание, което трябва да спре да се показва в точен час.
• changeDate: Датата и часът на последната промяна на съдържанието. Системата ги сравнява заедно с guid; използвайте различна стойност за всяка актуализация на съдържанието.
• media:content: Представителното изображение на елемента, извън групата с прикачени файлове. Посочете атрибутите url и type.
• content, image: Парсерът приема и тези имена на тагове със същите медийни атрибути. Тагът image служи като резервен вариант, когато основният URL на медийния файл не е зададен. Предпочитайте формата media:content; този псевдоним не поддържа произволни вложени структури image/url.
• media:group: Групата с прикачени файлове на елемента: изображения, видеоклипове, документи и вградено HTML съдържание.

Формати за дата и час

Използвайте стойност като 2026-10-17 08:30:00. Парсерът приема и T или t между датата и часа, дата като 17.10.2026, както и RSS дати като Sat, 17 Oct 2026 08:30:00 +0200.

Стойностите се обработват като местни дати и часове. Предоставеното отместване спрямо UTC не се използва за преобразуването им в UTC, затова използвайте последователно една договорена часова зона. Провереният парсер не поддържа времеви отметки по ISO 8601, завършващи на Z.

XML пример

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
    <channel>
        <item>
            <guid>offer-001</guid>
            <title>Latest offers</title>
            <description>Information about our current offers</description>
            <category>News</category>
            <pubDate>2026-10-17 08:00:00</pubDate>
            <changeDate>2026-10-17 08:30:00</changeDate>
            <link>https://example.org/offers/offer-001/</link>
            <media:content url="https://example.org/media/offer-001.jpg" type="image/jpeg"/>
            <media:group>
                <media:content url="https://example.org/media/offer-001.pdf" name="Offer details" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Details</h1><p>More information about this offer.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Адресите в example.org са примерни. Заменете ги с реални URL адреси, достъпни за RSS сървъра. Основният пример пропуска endDate, така че примерният елемент да не изтича автоматично.

Параметри на елементите

Таблицата определя задължителния формат за интеграция. Това, че парсерът допуска липсващи полета, не заменя правилно попълнените данни. Посочвайте и променяйте changeDate при актуализиране на съществуващ елемент.

Елементи в групата с медийни файлове

Изображение, документ или видео: добавете елемент media:content към групата и посочете неговите атрибути url и type. Незадължителният атрибут name задава етикет на прикачения файл.

HTML или обикновен текст: използвайте media:content type="text/html" и поставете съдържанието директно в елемента, например като HTML фрагмент в CDATA. За обикновен текст е достатъчен прост абзац. Показването на HTML прикачен файл не предоставя пълноценно уеб приложение; тази спецификация не гарантира изпълнение на JavaScript.

Ограничение за текстови прикачени файлове: самостоятелните прикачени файлове text/plain не се обработват правилно от проверената реализация. За текстов прикачен файл използвайте формата text/html, показана по-горе.

Поддържани типове съдържание

Това са входни формати на прикачени файлове, които системата съхранява или подготвя за показване според типа им. Успешната обработка зависи и от действителното съдържание и кодиране на файла; съвпадащият MIME тип сам по себе си не потвърждава, че преобразуването е приключило.