ICS (iCalendar)

Ultimo aggiornamento: 24 lug 2026ics.md

Panoramica

Importa appuntamenti da un file in formato iCalendar (.ics), lo standard RFC universale per l'esportazione di calendari (Google Calendar, Apple Calendar, Outlook, ecc.).
La migrazione legge il file .ics indicato come sorgente e importa tutti gli eventi come appuntamenti in Alfadocs.
È possibile assegnare gli appuntamenti importati a uno specifico operatore tramite il flag --converter-option=operator=<nome operatore> e applicare un colore tramite --converter-option=color=<valore colore>.
Gli appuntamenti ricorrenti (con regola RRULE) non vengono importati per ragioni di prestazioni e vengono scartati con un avviso.

Appuntamenti
Operatore (opzionale, creato se viene fornito il flag --converter-option=operator=<nome>)
Colore (opzionale, creato se viene fornito il flag --converter-option=color=<valore>)

Field	Notes
Titolo / Nome	Ricavato dal campo SUMMARY del file ICS, con eventuali emoji rimosse. Se presente, viene concatenato anche il campo DESCRIPTION (separato da virgola). Troncato a 254 caratteri.
Data e ora di inizio	Ricavata da DTSTART. Supporta: data pura, data+ora UTC, data+ora con fuso orario esplicito. Tutti i valori vengono convertiti nel fuso orario Europe/Berlin.
Durata (minuti)	Calcolata come differenza in minuti tra data di fine (DTEND) e data di inizio. Se DTEND è assente, viene assunta una durata di 15 minuti.
Frequenza ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati (vedi Limitazioni).
Intervallo ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Scadenza ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Conteggio ricorrenze	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Giorni della settimana ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Giorni del mese ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Date di esclusione ricorrenza	Sempre `null` — gli appuntamenti ricorrenti vengono saltati.
Operatore assegnato	Assegnato solo se viene fornito il flag `--converter-option=operator=<nome>`. Il nome viene suddiviso in nome e cognome automaticamente.
Colore	Assegnato solo se viene fornito il flag `--converter-option=color=<valore>`.

Field	Notes
Nome	Ricavato dalla prima parte del valore passato con `--converter-option=operator=<nome>`, suddiviso automaticamente in nome e cognome.
Cognome	Ricavato dalla seconda parte del valore passato con `--converter-option=operator=<nome>`.
Colore	Assegnato dall'opzione `--converter-option=color=<valore>`, se presente.

Field	Notes
Identificativo colore	Corrisponde al valore passato con `--converter-option=color=<valore>`. Usato anche come valore del colore di sfondo.
Riferimento	Impostato fisso al valore `custom_ics_color`.

Gli appuntamenti ricorrenti (RRULE) non vengono importati. Ogni evento con una regola di ricorrenza viene scartato con un avviso. Questa limitazione è esplicita nel codice per ragioni di prestazioni.
Nessun paziente importato. Il formato ICS non contiene anagrafica paziente; gli appuntamenti non sono collegati ad alcun paziente.
Nessun collegamento a piani di cura, prestazioni o fatture. La migrazione importa solo gli eventi come appuntamenti senza relazioni ad altri dati clinici.
Le emoji vengono rimosse dal titolo e dalla descrizione dell'evento.
Il fuso orario di destinazione è sempre Europe/Berlin, indipendentemente dal fuso originale del file ICS.
Il nome dell'appuntamento è troncato a 254 caratteri dopo la concatenazione di SUMMARY e DESCRIPTION.
Se DTEND è assente, la durata viene impostata automaticamente a 15 minuti.
L'operatore viene creato ex-novo al momento dell'import; non viene verificato se esiste già un operatore con lo stesso nome in Alfadocs.