Synchronisation CardDAV / CalDAV / ICS

Ce module pour Dolibarr 16.0/22.0 ajoute la synchronisation CardDAV / CalDAV et ICS. Il utilise la bibliothèque serveur Dolibarr [Sabre/DAV](http://sabre.io/dav/).

Vous pouvez :

• Lire et éditer les calendriers via CalDAV
• Lire et modifier les tâches d'un projet via CalDAV
• Lire et modifier les fiches d'intervention via CalDAV
• Lire et modifier les carnets d'adresses via CardDAV
• Lire les calendriers via ICS Full version ou seulement Free/Busy (cacher les détails)
• Accéder aux documents Dolibarr via WebDAV (si admin)
• Générer des tâches de projet à partir de documents tels que des propositions et/ou des commandes

Chaque utilisateur peut accéder à ses contacts et aux carnets d'adresses de tiers (contacts publics et privés), à son propre calendrier et aux calendriers des autres utilisateurs en fonction de ses droits.

Les informations de contact de Dolibarr remplissent les informations personnelles dans les cartes du logiciel client (y compris la photo du contact).

Les informations de la société (tiers) (à laquelle le contact est rattaché) remplissent les informations professionnelles dans les fiches du logiciel client.

Trois carnets d'adresses sont proposés à la synchronisation : Contacts, Membres (adhérents) et Tiers. Si vous souhaitez modifier les informations d'un tiers, faites-le dans le carnet d'adresses des tiers.

Il est possible de sélectionner les contacts à synchroniser avec la valeur de configuration CDAV_CONTACT_TAG dans Accueil / Configuration / Autre configuration. Entrez une valeur de tag de contact et seuls les contacts avec ce tag seront synchronisés (valeur vide pour tous).

Les enregistrements du calendrier dont le "Statut / Pourcentage" est réglé sur "Non applicable" sont convertis en événements dans CalDAV (VEVENT), les autres sont convertis en tâches (VTODO).

Les événements récurrents sont partiellement pris en charge (Dolibarr ne les gère pas entièrement). Lorsqu'un événement récurrent est créé, il est automatiquement dupliqué jusqu'à la date spécifiée (exclue) ou jusqu'à la durée maximale de synchronisation.

Génération automatique de tâches dans les projets avec des services provenant de Propositions et/ou de Commandes liées
La configuration du module permet de :

• générer des tâches à partir de document(s) lié(s) OU non
• synchroniser les tâches du projet en tant qu'événements du calendrier ET/OU en tant que tâches à faire
• définir 3 tâches initiales qui apparaîtront avant les services provenant du/des document(s)
• définir 3 tâches finales qui apparaîtront après les services provenant du/des document(s)
• définir le rôle de l'utilisateur dans le projet pour sélectionner l'utilisateur qui attribuera les tâches générées à partir du/des document(s)
• définir le rôle de l'utilisateur lors de la création d'une nouvelle tâche de projet
• définir l'heure de début et de fin d'une journée de travail
• limiter les services à convertir en tâches en spécifiant une étiquette
• forcer la génération de tâches pour chaque ligne de service à partir de documents attachés avec la durée cdav si le tag est manquant

Les durées sont extraites de la fiche du service si elles sont définies (minutes, heures, jours ou semaines uniquement), sinon elles sont extraites des champs supplémentaires remplis dans les documents.
Toutes les tâches commencent à la date de début du projet, au début de la journée de travail.
Les tâches de plusieurs jours sont gérées comme une seule tâche, par exemple du 31/07/2018 à 8h au 02/08/2018 à 19h.

Utilisation :

• Créer manuellement un projet, le lier à un tiers et en fixer la date ; le laisser à l'état de projet.
• Document(s) joint(s) : propositions ou commandes comprenant au moins 1 service concerné.
• Affecter le(s) contact(s) avec le rôle correct
• Valider le projet : toutes les tâches sont créées ; utiliser votre logiciel client ics pour récupérer et glisser-déposer les événements si nécessaire.

Notes :

• Les descriptions des services sont utiles pour créer des sous-tâches si des '-' sont détectés en début de ligne ; ensuite, avec DAVx⁵ (Synchronisation et client CalDAV/CardDAV) et Tâches (Suivez votre liste d'objectifs), vous pourrez utiliser des cases à cocher pour ces tâches.
• Si vous avez choisi de synchroniser les tâches du projet en tant qu'événements du calendrier ET tâches à faire, la modification d'une tâche modifiera automatiquement l'événement correspondant et réciproquement.
• Les tâches peuvent être modifiées depuis l'application client mais pas annulées : Dolibarr garde la trace de la dernière affectation.
• Après avoir généré des tâches, vous pouvez modifier/compléter chacune d'entre elles ou en créer d'autres manuellement (ici aussi vous pouvez remplir la zone de description avec des '-' en début de ligne pour créer des sous-tâches).

Module version: auto
Editeur/Licence: Befox SARL / GPLv3
Langage interface: Anglais/Français
Assistance: http://www.befox.fr/contact
Prérequis:

• Dolibarr min version: auto
• Dolibarr max version: auto

Installation:

• Télécharger le fichier archive du module (.zip) depuis le site web DoliStore.com
• Placer le fichier dans le répertoire racine de dolibarr.
• Decompressez le fichier zip, par exemple par la commande

unzip fichiermodule.zip

• Le module est alors disponible et activable.