15. AGENDA
15.1 Introduction
Le module Agenda permet de bénéficier d'un calendrier dans Dolibarr et de gérer des notions comme des événements ou des rendez-vous. Définition — Événements et rendez-vous Un événement (event dans la norme iCal) caractérise une action instantanée ou de longue durée, passée ou future. Il possède les caractéristiques suivantes :
Champ | Norme iCal | Description |
|---|---|---|
Libellé | summary | Intitulé de l'événement |
Description | description | Détail de l'événement |
Date de début | dtstart | — |
Date de fin ou durée | dtend / duration | L'une ou l'autre, pas les deux |
Lieu | location | Nom de salle, adresse… |
Priorité | priority | — |
Transparence | transp | Indique si les acteurs sont rendus indisponibles |
Statut | — | Tentative, confirmé ou annulé |
Exemple d'utilisation : les événements correspondent aux informations des calendriers Outlook, Evolution ou Thunderbird/Lightning (rendez-vous, travaux planifiés sur une plage de dates). Dans Dolibarr, ce module ajoute la notion de pourcentage d'avancement à la norme iCal.
Configuration du module Agenda
Le module se trouve dans la famille Projets/Travail collaboratif.
Figure 15.1 – Configuration du module Agenda
Onglet Divers — Paramètres
Figure 15.2 – Paramètres généraux de l'agenda
- Utiliser les types des événements (administrable dans Configuration > Dictionnaires > Liste des types d'événements de l'agenda) — on/off
- Type d'événement par défaut dans le filtre de recherche — choisissez dans la liste déroulante
- Statut d'événement par défaut dans le filtre — ex. À réaliser, En cours…
- Onglet affiché par défaut à l'ouverture du menu Agenda — Vue semaine, Vue mois…
Onglet Alimentation automatique de l'agenda Définissez les événements pour lesquels Dolibarr créera automatiquement une action dans l'agenda (ex. création d'une facture, validation d'une commande). Par défaut, aucune case n'est cochée : seules les actions manuelles sont incluses. Les événements automatiques sont créés au statut réalisé (pourcentage d'avancement = 100 %) avec une durée de 0 seconde (date de fin = date de début). Onglet Export calendrier
Figure 15.3 – Configuration de l'export calendrier
Cet onglet permet d'exporter une vue de votre agenda Dolibarr vers un calendrier externe (Thunderbird, Google Calendar…).
- Correction du fuseau horaire — ex. +2 (à renseigner uniquement si un décalage est constaté dans l'export)
Paramètres de filtrage disponibles dans l'URL d'export :
Paramètre | Effet |
|---|---|
logina=webmaster | Limite l'export aux actions dont webmaster est propriétaire |
logina=!webmaster | Limite l'export aux actions non assignées à webmaster |
logint=webmaster | Limite aux actions assignées à webmaster (propriétaire et autres) |
project=__PROJECT_ID__ | Restreint aux événements associés au projet spécifié |
notactiontype=systemauto | Exclut les événements automatiques |
Onglet Import calendriers externes
Figure 15.4 – Configuration de l'import de calendriers externes
Ajoutez des sources de calendriers externes pour les visualiser au sein de l'agenda Dolibarr (ex. import des jours fériés de l'année). Onglet Attributs supplémentaires Définissez les attributs supplémentaires non disponibles en standard sur les événements agenda. Les 24 types disponibles sont identiques à ceux des projets et tâches (voir chapitre Opportunités et Projets).
Figure 15.5 – Attributs supplémentaires de l'agenda
Exemple : pour ajouter un attribut de type Liste de sélection, renseignez un ordre, un libellé (ex. Au choix), un code d'attribut (ex. choix), choisissez le type Liste de sélection et saisissez les valeurs sous la forme clé -> valeur (ex. 1,valeur1...), puis enregistrez.
15.2 Événements
Dans Dolibarr, les événements sont aussi appelés actions. Il en existe deux catégories :
- Actions automatiques — créées automatiquement par Dolibarr lors d'événements métier configurés
- Actions manuelles — créées explicitement par l'utilisateur
Créer un nouvel événement
- Type — ex. Rendez-vous, Appel téléphonique…
- Événement sur la journée — si cochée, le choix des horaires est grisé
- Date de début et date de fin
- État / Pourcentage d'avancement — si applicable
- Affectation — utilisateur(s) concerné(s)
Cliquez sur Ajouter. L'événement apparaît dans la liste des événements.
Modifier un événement
Depuis Événement > Liste dans le menu latéral gauche, choisissez l'événement dans la liste, cliquez sur son lien hypertexte pour ouvrir la fiche, puis cliquez sur Modifier.
Supprimer un événement
Depuis Événement > Liste, ouvrez la fiche de l'événement et cliquez sur Supprimer. Confirmez en répondant positivement à la question Êtes-vous sûr de vouloir effacer cet événement ?
Options cachées
Constante | Effet |
|---|---|
AGENDA_MAX_EVENTS_DAY_VIEW | Nombre maximum d'entrées visibles par jour dans l'agenda (défaut : 3 ; 0 = aucune limite) |
Constante | Effet |
|---|---|
AGENDA_USE_EVENT_TYPE | Ajoute un champ obligatoire « Type » lors de la création d'un événement (obsolète) |
AGENDA_AUTOSET_END_DATE_WITH_DELTA_HOURS | Définit automatiquement la date de fin à la date de début + delta lors de la création |
MAIN_ADD_EVENT_ON_ELEMENT_CARD | Permet de créer un événement directement depuis la fiche d'un document (proposition, commande, facture) |