---
title: "Import ICS et calendrier"
weight: 50
description: "Créer des sessions à partir d'un calendrier iCalendar et publier les sessions au format ICS."
---

# Import ICS et calendrier

Le module Présence permet de créer des sessions automatiquement à partir d'un fichier iCalendar (`.ics`) ou d'une URL de calendrier en ligne, et de publier les sessions du module au format ICS pour les afficher dans n'importe quel agenda externe (Google Agenda, Outlook, Thunderbird, agenda mobile).

## Importer un calendrier ICS

### Sources supportées

- Fichier `.ics` local téléversé depuis votre poste.
- URL de calendrier en ligne (par exemple un calendrier Google partagé en lecture seule).

### Lancer l'import

1. Dans le menu principal, cliquez sur **Présence > Importer un calendrier ICS**.
2. Choisissez la source :
   - **Fichier** : sélectionnez le fichier `.ics`.
   - **URL** : collez l'URL publique du calendrier.
3. Sélectionnez les options d'import :
   - **Type de session** par défaut pour les événements importés.
   - **Période** à importer (utile si le calendrier contient un long historique).
   - **Filtrer par mot-clé** dans le titre des événements (par exemple "Formation" pour ne créer des sessions que pour les événements de formation).
4. Cliquez sur **Prévisualiser**.

![Page d'import ICS avec la liste des événements détectés et leur statut](screenshots/ics-import-previsualisation.webp)

5. Le module affiche la liste des événements détectés et indique :
   - **Nouveau** : sera créé comme nouvelle session.
   - **Existant** : déjà importé précédemment, sera mis à jour si modifié.
   - **Ignoré** : ne correspond pas aux filtres.
6. Cliquez sur **Importer** pour confirmer.

### Champs ICS pris en compte

| Champ ICS | Champ session Présence |
|-----------|------------------------|
| `SUMMARY` | Libellé |
| `DESCRIPTION` | Description |
| `DTSTART` | Date + heure de début |
| `DTEND` | Heure de fin |
| `LOCATION` | Lieu |
| `UID` | Référence d'import (pour éviter les doublons) |

### Gestion des doublons

Le module utilise l'`UID` ICS de chaque événement comme clé d'import. Si vous relancez un import avec le même fichier ou la même URL :

- Les événements déjà importés (UID connu) sont **mis à jour** si leur contenu a changé.
- Les événements supprimés du calendrier source ne sont **pas** supprimés côté Dolibarr (les sessions et signatures sont préservées).

## Publier les sessions au format ICS

Chaque session de présence dispose d'une URL ICS publique qui permet de l'afficher dans n'importe quel agenda externe.

### Récupérer l'URL ICS d'une session

1. Ouvrez la fiche de la session.
2. Dans le bloc d'informations latéral, cliquez sur **Lien ICS** (ou ouvrez l'onglet **Documents**).
3. Copiez l'URL.

### Ajouter le calendrier dans un agenda externe

- **Google Agenda** : ouvrez Google Agenda, cliquez sur le `+` à côté de "Autres agendas", puis "À partir de l'URL". Collez l'URL.
- **Outlook** : Fichier > Paramètres du compte > Calendriers Internet > Nouveau, puis collez l'URL.
- **Thunderbird** : clic droit dans le panneau des agendas > Nouveau calendrier > Sur le réseau, puis collez l'URL.
- **iOS / macOS** : Réglages > Calendrier > Comptes > Ajouter un compte > Autre > Ajouter un compte CalDAV.

L'agenda externe se synchronise automatiquement à intervalle régulier (entre quelques minutes et quelques heures selon le client).

## Calendrier global du module

Le menu **Présence > Calendrier** affiche toutes les sessions sous forme d'agenda mensuel ou hebdomadaire directement dans Dolibarr.

![Vue calendrier mensuelle du module Présence](screenshots/ics-calendrier-vue.webp)

### Filtres

Vous pouvez filtrer la vue par :

- **Type de session**.
- **Statut** (Brouillon, Validée, Clôturée, Annulée).
- **Projet** ou **Tiers** rattaché.

### Navigation

- Cliquez sur un événement pour ouvrir la fiche de la session.
- Utilisez les flèches en haut pour passer au mois ou à la semaine précédent/suivant.
- Le bouton **Aujourd'hui** ramène la vue au mois courant.

## Synchronisation avec l'agenda Dolibarr

Si le module **Agenda** de Dolibarr est activé, chaque session de présence apparaît automatiquement dans l'agenda standard de Dolibarr. Cela permet de croiser les sessions de présence avec les autres événements de l'organisation (rendez-vous commerciaux, tâches, etc.).

## Étape suivante

Pour propager les événements du module vers d'autres systèmes (CRM, plateforme externe), consultez la page [Webhooks](/presence/webhooks).