Convertidor online gratuito de ICS a XML

Una aplicación de calendario o una plataforma de integración puede requerir XML en lugar de un archivo iCalendar para importar, consultar, archivar o intercambiar datos de eventos. La conversión debe traducir las propiedades del calendario a un vocabulario XML; cambiar la extensión .ics no convierte el archivo.

Qué es el formato ICS

ICS es la extensión de nombre de archivo utilizada habitualmente para los datos de iCalendar, cuya sintaxis principal está definida por RFC 5545. Es un formato de texto compatible con UTF-8 que incluye componentes como eventos VEVENT, tareas VTODO y entradas VJOURNAL. Entre las propiedades comunes se incluyen UID, DTSTART, DTEND, SUMMARY, LOCATION, asistentes, reglas de recurrencia, alarmas y definiciones de zonas horarias.

Microsoft Outlook, Apple Calendar, Google Calendar, Mozilla Thunderbird y muchos sistemas de programación crean o importan archivos ICS. Se utilizan habitualmente para invitaciones a eventos, exportaciones de calendarios, transferencias de citas y archivos adjuntos de reuniones. ICS contiene datos de calendario, no es un formato de contactos ni de CAD.

Qué es el formato XML

XML es un formato de texto jerárquico que representa datos estructurados mediante elementos, atributos, espacios de nombres y definiciones de esquema opcionales. XML admite la validación con XSD, las consultas con XPath y la transformación con XSLT, por lo que resulta adecuado para sistemas que requieren una estructura de intercambio o archivado definida.

XML no tiene un vocabulario de calendario universal integrado. La aplicación receptora debe especificar los nombres de sus elementos, espacios de nombres, campos obligatorios y tipos de datos. xCal, definido por RFC 6321, es la representación XML estandarizada de los datos de iCalendar; úselo cuando el sistema de destino sea compatible con xCal. De lo contrario, asigne las propiedades de ICS al esquema XML personalizado del receptor.

Cómo convertir un archivo ICS a XML

Para una conversión puntual, utilice el conversor de 101convert.com: cargue el archivo .ics, elija XML como formato de salida, inicie la conversión y descargue el archivo .xml resultante. Compruebe que la estructura de elementos generada coincida con los requisitos de la aplicación que realizará la importación. No cargue calendarios que contengan información confidencial a menos que las condiciones de tratamiento y conservación del servicio sean aceptables.

Para conversiones repetibles o archivos que requieran una asignación de campos controlada, utilice un analizador en lugar de expresiones regulares. El paquete icalendar de Python analiza líneas plegadas, texto escapado, fechas, zonas horarias y componentes de calendario; el módulo xml.etree.ElementTree de la biblioteca estándar escribe XML.

1. Instale el analizador con python -m pip install icalendar.
2. Lea el archivo ICS en modo binario y analícelo con Calendar.from_ical().
3. Recorra los componentes necesarios y asigne cada propiedad de origen al esquema XML de destino.
4. Serialice las fechas y fechas-horas de forma deliberada, conserve la información de zona horaria y escriba XML UTF-8 con una declaración XML.
5. Valide el resultado con el XSD del receptor o genere la estructura xCal de RFC 6321 si ese es el formato requerido.

from icalendar import Calendar
import xml.etree.ElementTree as ET

with open("calendar.ics", "rb") as source:
    calendar = Calendar.from_ical(source.read())

root = ET.Element("calendar")
for component in calendar.walk("VEVENT"):
    event = ET.SubElement(root, "event")
    for source_name, target_name in (
        ("UID", "uid"), ("SUMMARY", "summary"),
        ("DTSTART", "start"), ("DTEND", "end"),
        ("LOCATION", "location"), ("DESCRIPTION", "description")
    ):
        value = component.get(source_name)
        if value is None:
            continue
        data = getattr(value, "dt", value)
        element = ET.SubElement(event, target_name)
        element.text = data.isoformat() if hasattr(data, "isoformat") else str(data)

ET.ElementTree(root).write(
    "calendar.xml", encoding="utf-8", xml_declaration=True
)

Este script crea un vocabulario XML personalizado pequeño, no xCal. Amplíe la asignación para incluir asistentes, organizadores, alarmas, archivos adjuntos, reglas de recurrencia, RECURRENCE-ID, EXDATE y otras propiedades, o sustituya los nombres de elementos y espacios de nombres por los requeridos por el esquema de destino.

Comprobaciones de calidad y compatibilidad

Cambiar el nombre de calendar.ics a calendar.xml deja sin cambios la sintaxis interna de iCalendar y no produce XML válido.

El tratamiento de las horas requiere especial cuidado. Conserve los valores de TZID, las compensaciones UTC, las horas flotantes y las reglas de horario de verano. Convertir una hora local en una cadena simple puede cambiar las citas cuando otro sistema la interpreta en una zona horaria diferente. Conserve las reglas de recurrencia y sus excepciones, incluidas RECURRENCE-ID y EXDATE.

Después de la conversión, verifique los eventos recurrentes, los eventos de día completo, las alarmas, los asistentes, los datos del organizador, los archivos adjuntos, el texto no ASCII y los eventos cancelados. Un analizador de iCalendar debe descodificar las líneas plegadas y los valores escapados como \,, \; y \n; la sustitución básica de cadenas puede corromper los límites de los campos o el texto.