Integración RSS

Referencia técnica

Cómo funciona la sincronización

1. El servidor obtiene el canal RSS configurado y compara los identificadores de los elementos y los valores de changeDate con los registros almacenados.
2. Se procesan los elementos nuevos y modificados. El servidor descarga sus archivos multimedia y los envía al servicio de archivos para almacenarlos y convertirlos si es necesario; se eliminan los elementos y archivos sin uso.
3. El servidor notifica al portal los cambios detectados. El portal organiza después el envío de los datos actualizados a los dispositivos que utilizan el canal.
4. Cada dispositivo guarda los datos recibidos y descarga los adjuntos necesarios por separado. Recibir una definición no confirma por sí solo que hayan terminado todas las descargas multimedia.

Consulte Configuración de aplicaciones RSS para conocer el intervalo de comprobación y la asignación de aplicaciones. Las actualizaciones no son inmediatas: la preparación de archivos y la conexión del dispositivo también afectan al envío.

La sincronización descrita presupone un canal con al menos un elemento válido. No confíe en vaciar el canal como forma garantizada de dejar de mostrar su contenido.

Cómo detecta el sistema los cambios de elementos

• Un guid en la definición nueva que no estaba en la anterior → elemento nuevo; se descargan y preparan sus archivos.
• Un guid anterior que falta en la definición nueva → elemento eliminado; se retiran sus archivos.
• El guid existe en ambas, pero changeDate cambia → elemento modificado; se retiran los archivos anteriores y se descargan y preparan los nuevos.

Al cambiar un título, descripción, enlace o adjunto, mantenga el valor de guid y cambie changeDate. Esto también se aplica al sustituir un archivo sin cambiar su URL. Reordenar elementos puede no activar el envío de una definición nueva; actualice también changeDate para que se envíe el cambio.

Propiedades principales

• guid: Un identificador único y estable del elemento, como el ID de un registro de base de datos. Manténgalo al editar el contenido.
• title: Un título obligatorio y no vacío. Se aceptan etiquetas HTML, pero la lista y el encabezado del detalle muestran texto plano.
• description: La descripción del elemento. Puede contener HTML; la visualización con formato depende de los ajustes de la aplicación RSS.
• category: Un nombre de categoría utilizado para filtrar. El selector aparece si el canal tiene al menos una categoría no vacía.
• link: La URL absoluta de una página relacionada. Un enlace que empieza por http también aparece como código QR en los detalles para utilizarlo desde un móvil.
• pubDate: La fecha y hora de creación. No programa su publicación: una fecha futura no impide que se muestre.
• endDate: La fecha y hora de fin de vigencia. Este campo no garantiza la retirada inmediata según el reloj del dispositivo, especialmente sin conexión. No dependa solo de él para contenido que deba desaparecer a una hora exacta.
• changeDate: La fecha y hora del último cambio. El sistema las compara junto con guid; utilice un valor distinto en cada actualización.
• media:content: La imagen representativa del elemento, fuera del grupo de adjuntos. Proporcione los atributos url y type.
• content, image: El analizador también acepta estos nombres de etiqueta con los mismos atributos multimedia. image actúa como alternativa si no se ha definido la URL principal. Utilice preferentemente media:content; este alias no admite estructuras image/url anidadas arbitrariamente.
• media:group: El grupo de adjuntos del elemento: imágenes, vídeos, documentos y contenido HTML integrado.

Formatos de fecha y hora

Utilice un valor como 2026-10-17 08:30:00. El analizador también acepta T o t entre fecha y hora, una fecha como 17.10.2026 y fechas RSS como Sat, 17 Oct 2026 08:30:00 +0200.

Los valores se tratan como fechas y horas locales. El desfase UTC indicado no se utiliza para convertirlos a UTC; use siempre una zona horaria acordada. El analizador verificado no admite marcas ISO 8601 terminadas en Z.

Ejemplo 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>Últimas ofertas</title>
            <description>Información sobre nuestras ofertas actuales</description>
            <category>Noticias</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="Detalles de la oferta" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Detalles</h1><p>Más información sobre esta oferta.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Las direcciones de example.org son marcadores. Sustitúyalas por URL reales accesibles desde el servidor RSS. El ejemplo básico omite endDate para que el elemento no caduque automáticamente.

Parámetros de los elementos

La tabla define el formato de integración requerido. Que el analizador tolere campos ausentes no sustituye los datos correctamente cumplimentados. Proporcione y cambie changeDate al actualizar un elemento existente.

Elementos del grupo multimedia

Imagen, documento o vídeo: añada al grupo un elemento media:content y proporcione sus atributos url y type. El atributo opcional name proporciona la etiqueta del adjunto.

HTML o texto plano: utilice media:content type="text/html" y coloque el contenido directamente dentro del elemento, por ejemplo como fragmento HTML en CDATA. Un párrafo sencillo basta para texto plano. Mostrar un adjunto HTML no ofrece una aplicación web completa; esta especificación no garantiza la ejecución de JavaScript.

Limitación de adjuntos de texto: los adjuntos independientes text/plain no se procesan correctamente en la implementación verificada. Para un adjunto de texto, utilice la forma text/html mostrada arriba.

Tipos de contenido admitidos

Son formatos de entrada de adjuntos que el sistema almacena o prepara para mostrar según el tipo. El procesamiento también depende del contenido real y la codificación del archivo; un tipo MIME correcto no confirma por sí solo que haya terminado la conversión.