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.

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

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.

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.