RSS-Integration

Technische Referenz

So funktioniert die Synchronisierung

1. Der Server ruft den konfigurierten RSS-Feed ab und vergleicht Eintragskennungen und changeDate Werte mit den gespeicherten Datensätzen.
2. Neue und geänderte Einträge werden verarbeitet. Der Server lädt die Medien herunter und sendet sie zum Speichern und gegebenenfalls Konvertieren an den Dateidienst. Nicht mehr benötigte Einträge und Medien werden bereinigt.
3. Der Server meldet eine erkannte Änderung an das Portal. Das Portal veranlasst anschließend die Übertragung der aktualisierten Daten an Geräte, die den Kanal verwenden.
4. Jedes Gerät speichert die empfangenen Daten und lädt erforderliche Anhänge separat herunter. Der Empfang einer Definition allein bestätigt nicht, dass alle Mediendownloads abgeschlossen sind.

Siehe RSS-Anwendung konfigurieren zum Feed-Prüfintervall und zur Anwendungszuordnung. Updates erfolgen nicht sofort: Auch Medienaufbereitung und Geräteverbindung beeinflussen die Übertragung.

Die hier beschriebene Synchronisierung setzt einen Feed mit mindestens einem gültigen Eintrag voraus. Verlassen Sie sich nicht darauf, dass das Leeren des Feeds seine Anzeige garantiert beendet.

So erkennt das System Eintragsänderungen

• Ein guid in der neuen, aber nicht in der alten Definition → neuer Eintrag; seine Medien werden heruntergeladen und aufbereitet.
• Ein bisheriger guid fehlt in der neuen Definition → entfernter Eintrag; seine Medien werden entfernt.
• Die guid ist in beiden vorhanden, aber changeDate unterscheidet sich → geänderter Eintrag; alte Medien werden entfernt und neue heruntergeladen und aufbereitet.

Wenn Sie Titel, Beschreibung, Link oder Anhang ändern, behalten Sie den Wert von guid und ändern Sie changeDate. Dies gilt auch, wenn Sie eine Datei unter gleichbleibender URL ersetzen. Das bloße Umordnen von Einträgen löst möglicherweise keine neue Übertragung aus. Aktualisieren Sie auch changeDate, damit die Änderung übertragen wird.

Wichtigste Eigenschaften

• guid: Eine eindeutige, stabile Eintragskennung, etwa die ID eines Datenbankdatensatzes. Behalten Sie sie bei Inhaltsänderungen bei.
• title: Ein erforderlicher, nicht leerer Titel. HTML-Tags sind zulässig, die Überschriften in Liste und Detailansicht zeigen jedoch Klartext.
• description: Die Beschreibung des Eintrags. Sie kann HTML enthalten; die formatierte Anzeige hängt von den Einstellungen der RSS-Anwendung ab.
• category: Ein Kategoriename zum Filtern. Die Kategorieauswahl erscheint, wenn der Kanal mindestens eine nicht leere Kategorie enthält.
• link: Die absolute URL einer zugehörigen Webseite. Ein mit http beginnender Link wird in den Eintragsdetails zusätzlich als QR-Code für Mobilgeräte angezeigt.
• pubDate: Datum und Uhrzeit der Erstellung. Dies plant keine Freigabe: Ein Datum in der Zukunft verhindert nicht die Anzeige des Eintrags.
• endDate: Enddatum und -uhrzeit der Gültigkeit. Dieses Feld garantiert keine sofortige Entfernung anhand der Geräteuhr, insbesondere bei einem Offlinegerät. Verlassen Sie sich bei Inhalten, die zu einem exakten Zeitpunkt verschwinden müssen, nicht allein darauf.
• changeDate: Datum und Uhrzeit der letzten Inhaltsänderung. Das System vergleicht diesen Wert zusammen mit guid. Verwenden Sie bei jeder Inhaltsaktualisierung einen anderen Wert.
• media:content: Das repräsentative Bild des Eintrags außerhalb der Anhangsgruppe. Geben Sie die Attribute url und type an.
• content, image: Der Parser akzeptiert auch diese Tagnamen mit denselben Medienattributen. Das Tag image dient als Ersatz, wenn keine Hauptmedien-URL gesetzt ist. Verwenden Sie vorzugsweise media:content. Beliebig verschachtelte image/url-Strukturen werden durch diesen Alias nicht unterstützt.
• media:group: Die Anhangsgruppe des Eintrags: Bilder, Videos, Dokumente und eingebetteter HTML-Inhalt.

Datums- und Uhrzeitformate

Verwenden Sie einen Wert wie 2026-10-17 08:30:00. Der Parser akzeptiert außerdem T oder t zwischen Datum und Uhrzeit, ein Datum wie 17.10.2026 sowie RSS-Datumsangaben wie Sat, 17 Oct 2026 08:30:00 +0200.

Werte werden als lokale Datums- und Uhrzeitangaben verarbeitet. Der übergebene UTC-Offset wird nicht zur Umrechnung in UTC verwendet. Nutzen Sie daher durchgängig eine vereinbarte Zeitzone. ISO-8601-Zeitstempel mit abschließendem Z werden vom geprüften Parser nicht unterstützt.

XML-Beispiel

<?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>Aktuelle Angebote</title>
            <description>Informationen zu unseren aktuellen Angeboten</description>
            <category>Nachrichten</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="Angebotsdetails" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Details</h1><p>Weitere Informationen zu diesem Angebot.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Die Adressen unter example.org sind Platzhalter. Ersetzen Sie sie durch echte URLs, die der RSS-Server erreichen kann. Im Basisbeispiel fehlt endDate, damit der Beispieleintrag nicht automatisch abläuft.

Eintragsparameter

Die Tabelle definiert das erforderliche Integrationsformat. Dass der Parser fehlende Felder toleriert, ersetzt keine korrekt ausgefüllten Daten. Geben Sie bei Änderungen eines bestehenden Eintrags einen neuen Wert an für changeDate.

Einträge der Mediengruppe

Bild, Dokument oder Video: Fügen Sie der Gruppe ein media:content Element hinzu und geben Sie seine Attribute an: url und type. Das optionale Attribut name gibt eine Anhangsbeschriftung an.

HTML oder Klartext: verwenden Sie media:content type="text/html" und setzen Sie den Inhalt direkt in das Element, etwa als HTML-Fragment in CDATA. Für Klartext reicht ein einfacher Absatz. Die Anzeige eines HTML-Anhangs stellt keine vollständige Webanwendung bereit. Diese Spezifikation garantiert keine JavaScript-Ausführung.

Einschränkung bei Textanhängen: Eigenständige text/plain Anhänge werden von der geprüften Implementierung nicht korrekt verarbeitet. Verwenden Sie für einen Textanhang die oben gezeigte Form text/html.

Unterstützte Inhaltstypen

Dies sind Eingabeformate für Anhänge, die das System je nach Typ speichert oder für die Anzeige aufbereitet. Die erfolgreiche Verarbeitung hängt auch von tatsächlichem Dateiinhalt und Codierung ab. Ein passender MIME-Typ allein bestätigt keine abgeschlossene Konvertierung.