Conversor online gratuito de ICS para XML

Um aplicativo de calendário ou uma plataforma de integração pode exigir XML em vez de um arquivo iCalendar para importar, consultar, arquivar ou trocar dados de eventos. A conversão deve traduzir as propriedades do calendário para um vocabulário XML; alterar a extensão .ics não converte o arquivo.

O que é o formato ICS

ICS é a extensão de nome de arquivo comumente usada para dados iCalendar, cuja sintaxe principal é definida pela RFC 5545. É um formato de texto compatível com UTF-8, com componentes como eventos VEVENT, tarefas VTODO e entradas VJOURNAL. As propriedades comuns incluem UID, DTSTART, DTEND, SUMMARY, LOCATION, participantes, regras de recorrência, alarmes e definições de fuso horário.

Microsoft Outlook, Apple Calendar, Google Calendar, Mozilla Thunderbird e muitos sistemas de agendamento criam ou importam arquivos ICS. Eles são comumente usados para convites de eventos, exportações de calendários, transferências de compromissos e anexos de reuniões. ICS contém dados de calendário, não é um formato de contatos ou CAD.

O que é o formato XML

XML é um formato de texto hierárquico que representa dados estruturados com elementos, atributos, namespaces e definições de esquema opcionais. XML permite validação com XSD, consultas com XPath e transformação com XSLT, sendo adequado para sistemas que exigem uma estrutura definida de intercâmbio ou arquivamento.

XML não possui um vocabulário de calendário universal integrado. O aplicativo receptor deve especificar seus nomes de elementos, namespaces, campos obrigatórios e tipos de dados. xCal, definido pela RFC 6321, é a representação XML padronizada de dados iCalendar; use-o quando o sistema de destino for compatível com xCal. Caso contrário, mapeie as propriedades ICS para o esquema XML personalizado do destinatário.

Como converter um arquivo ICS para XML

Para uma conversão pontual, use o conversor em 101convert.com: carregue o arquivo .ics, escolha XML como formato de saída, inicie a conversão e baixe o arquivo .xml resultante. Verifique a estrutura dos elementos gerados em relação aos requisitos do aplicativo de importação. Não carregue calendários que contenham informações confidenciais, a menos que os termos de tratamento e retenção do serviço sejam aceitáveis.

Para conversões repetíveis ou arquivos que exigem mapeamento controlado de campos, use um parser em vez de expressões regulares. O pacote icalendar do Python analisa linhas dobradas, texto escapado, datas, fusos horários e componentes de calendário; o módulo xml.etree.ElementTree da biblioteca padrão grava XML.

1. Instale o parser com python -m pip install icalendar.
2. Leia o arquivo ICS no modo binário e analise-o com Calendar.from_ical().
3. Percorra os componentes necessários e mapeie cada propriedade de origem para o esquema XML de destino.
4. Serialize datas e data-horas deliberadamente, preserve as informações de fuso horário e grave XML UTF-8 com uma declaração XML.
5. Valide o resultado em relação ao XSD do destinatário ou gere a estrutura xCal da RFC 6321 se esse for o formato exigido.

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 cria um pequeno vocabulário XML personalizado, não xCal. Estenda o mapeamento para participantes, organizadores, alarmes, anexos, regras de recorrência, RECURRENCE-ID, EXDATE e outras propriedades, ou substitua os nomes dos elementos e namespaces pelos exigidos pelo esquema de destino.

Verificações de qualidade e compatibilidade

Renomear calendar.ics para calendar.xml mantém a sintaxe interna do iCalendar inalterada e não produz XML válido.

O tratamento de horários exige atenção especial. Preserve os valores de TZID, os deslocamentos UTC, os horários flutuantes e as regras de horário de verão. Converter um horário local em uma string simples pode alterar os horários dos compromissos quando outro sistema o interpreta em um fuso horário diferente. Preserve as regras de recorrência e suas exceções, incluindo RECURRENCE-ID e EXDATE.

Após a conversão, verifique eventos recorrentes, eventos de dia inteiro, alarmes, participantes, dados do organizador, anexos, texto não ASCII e eventos cancelados. Um parser iCalendar deve decodificar linhas dobradas e valores escapados, como \,, \; e \n; a substituição básica de strings pode corromper os limites dos campos ou o texto.