Agenda

L'agenda d'iREN centralise la consultation et l'organisation des rendez-vous. Il permet de lire la charge des intervenants, de poser de nouveaux créneaux, de déclarer des indisponibilités et de préparer l'export du planning.

Cette page a été revue sur l'environnement de recette en version 1.14.0.305 le 13/04/2026. Les captures sont historisées par date et par version afin de conserver la lecture des évolutions de l'outil.

Version 1.14.0.305 du 13/04/2026 - vue générale du planning

Rôle de l'agenda

L'agenda sert à organiser les déplacements et les rendez-vous liés aux dossiers. Il regroupe dans une même interface :

• la lecture du planning par semaine, par jour, par mois, par ressource ou en liste
• la pose des rendez-vous de type métré, travaux, urgent ou RDF
• la gestion des indisponibilités
• l'accès à un mode carte
• l'export du pré-planning ou du planning

L'agenda est donc à la fois un outil de consultation et un outil de pilotage. Il s'appuie sur le même référentiel que les dossiers, les SMS, les modèles de SMS, les états dossier et les intervenants issus de l'Annuaire.

Lire le planning

La zone centrale présente les rendez-vous planifiés. Le panneau de gauche pilote le périmètre affiché.

Version 1.14.0.305 du 13/04/2026 - panneau des paramètres

Le panneau des paramètres permet de :

• sélectionner les intervenants à afficher
• filtrer les types de rendez-vous
• choisir la taille des zones de travail
• lancer l'export du pré-planning ou du planning

La sélection des intervenants est une règle centrale du module :

• aucun rendez-vous ne s'affiche tant qu'aucun intervenant n'est coché
• les intervenants sont regroupés par source
• la même sélection est réutilisée dans les formulaires pour proposer les collaborateurs disponibles

Le filtre Type de rendez-vous agit sur la lecture du planning. Il permet de masquer ou d'afficher séparément les rendez-vous métré, travaux, urgent, RDF et les indisponibilités.

La taille des zones fait varier le pas de travail du planning. En pratique, elle influence la granularité de sélection d'un nouveau créneau et la manière d'ajuster un rendez-vous.

• 

  Vue semaine

• 

  Vue jour

• 

  Vue mois

• 

  Vue planning en liste

• 

  Vue ressource sur une journée

• 

  Vue ressource sur une semaine

• 

  Vue indisponibilités

• 

  Vue carte

Les vues répondent à des usages différents :

• Mois donne une lecture synthétique de la charge
• Semaine et Jour servent au réglage fin des créneaux
• Planning affiche la semaine sous forme de liste chronologique
• les vues Jour et Semaine situées après le bouton Planning classent les rendez-vous par ressource
• Indispos isole les absences et plages non affectables
• la carte permet une lecture géographique des rendez-vous

Repère technique : la barre de vues repose sur les modes `dayGridMonth`, `timeGridWeek`, `timeGridDay`, `listWeek`, `resourceTimelineDay`, `resourceTimelineWeek` et `indispos`.

Pré-planning et export planning

Le bloc d'export affiché dans le panneau de gauche ne fonctionne pas toujours de la même manière. Selon le paramétrage du site, iREN propose soit un pré-planning hebdomadaire, soit un export planning classique sur une période choisie.

Pré-planning hebdomadaire

Sur l'environnement observé le 13/04/2026, le site affichait un bloc Pré-planning.

Version 1.14.0.305 du 13/04/2026 - export du pré-planning

Fonctionnellement, ce mode sert à produire un fichier hebdomadaire de préparation :

• l'utilisateur choisit une semaine au format `AAAA-Wss`
• iREN propose par défaut la semaine suivante
• le fichier porte sur la semaine choisie
• si aucun rendez-vous n'est exportable sur cette semaine, iREN affiche un message dédié au lieu d'envoyer un fichier inexploitable

La règle métier la plus importante est la suivante :

• ce mode n'est pas un export personnalisé du planning affiché
• il ne demande pas de date début / date fin
• il ne reprend pas les collaborateurs cochés comme critère de constitution du fichier
• il ne reprend pas non plus les filtres actifs du planning comme périmètre d'export

Autrement dit, l'écran du planning sert ici surtout à se repérer et à choisir la bonne semaine. Le contenu du fichier dépend ensuite du traitement hebdomadaire prévu pour le site.

Comment la semaine est interprétée

Dans le moteur d'export, la semaine choisie est transformée en période ouvrée :

• le début correspond au lundi
• la fin correspond au vendredi
• la sélection ne couvre donc pas le week-end
• le titre du fichier reprend explicitement ces deux bornes

Le filtrage se fait ensuite sur la date de rendez-vous du dossier. Le pré-planning ne raisonne donc pas sur une plage horaire affichée à l'écran, mais sur les rendez-vous métier dont la date tombe dans cette semaine ouvrée.

Quels rendez-vous sont retenus

D'après le code actuel, le pré-planning applique les règles suivantes :

• seuls les rendez-vous de famille PV sont pris en compte
• les rendez-vous annulés sont exclus
• les rendez-vous métré et les indisponibilités ne sont pas exportés
• l'export ne réutilise pas les filtres d'affichage du planning
• au niveau SQL, le moteur ne distingue pas les variantes travaux, urgent ou RDF : il travaille sur la famille `PV`

Le pré-planning s'appuie aussi sur le lien entre le rendez-vous de suivi et son rendez-vous de planning. Cela permet notamment de reprendre le commentaire du planning dans le fichier exporté.

Comment iREN sépare Travaux et SAV

Le fichier n'utilise pas un indicateur SAV explicite. La séparation se fait à partir du premier rendez-vous PV du dossier :

• la feuille Travaux contient les dossiers dont le rendez-vous exporté tombe sur la première date PV du dossier
• la feuille SAV contient les autres rendez-vous PV du dossier, c'est-à-dire ceux qui tombent sur une date différente de la première
• si plusieurs rendez-vous existent le même jour que cette première date, ils restent tous classés dans Travaux

Cette règle est importante pour la lecture métier : dans le pré-planning, SAV signifie ici "rendez-vous postérieurs au premier passage", et non "rendez-vous portant un drapeau SAV spécifique".

Comment le fichier est présenté

Le moteur prépare jusqu'à deux feuilles Excel :

• une feuille Travaux
• une feuille SAV

La feuille Travaux affiche notamment :

• le nom du client
• le code postal
• le téléphone et le portable
• la référence du donneur d'ordre
• l'expert
• le montant hors taxes
• la franchise
• la date et l'heure
• le commentaire
• le compagnon

La feuille SAV reprend une structure proche, avec une lecture orientée suivi :

• le nom du client
• le téléphone et le portable
• la référence du donneur d'ordre
• l'expert
• une colonne prévue pour Reprise à faire
• la date et l'heure
• le commentaire
• le compagnon

Le rendu final ajoute aussi plusieurs repères de lecture :

• une case à cocher en début de ligne pour chaque rendez-vous exporté
• un titre de semaine en haut de feuille
• sur la feuille Travaux, un total du montant des travaux
• le type d'activité affiché comme ligne de regroupement au-dessus du rendez-vous lorsqu'il est connu

D'où viennent les informations affichées

Le contenu du pré-planning ne vient pas d'une seule table. Il est recomposé à partir de plusieurs sources métier :

• l'identité et les coordonnées du client viennent des personnes rattachées au dossier
• l'expert et la référence donneur d'ordre viennent du dossier
• le commentaire provient du rendez-vous de planning associé
• le compagnon correspond au technicien associé, sauf lorsqu'il s'agit du technicien par défaut, auquel cas la cellule reste vide
• le montant et le type d'activité sont alimentés à partir des devis transférés en commande lorsqu'ils existent

Deux nuances utiles à retenir :

• l'absence de montant ou de type d'activité n'empêche pas l'export d'une ligne
• lorsque la franchise est marquée comme récupérée, le fichier affiche une franchise à 0

Repères d'évolution

Le code source garde la trace de plusieurs évolutions du pré-planning :

• à l'origine, l'export s'appuyait surtout sur les commandes
• une évolution a ensuite relié plus directement le fichier au commentaire du planning
• la version actuelle s'appuie sur les devis transférés en commande pour enrichir le montant et le type d'activité
• la présentation actuelle reformate aussi les numéros de téléphone pour améliorer leur lecture dans Excel

Repères techniques :

• l'activation dépend du paramètre Eurogex `PLANNING / Export planning semaine`
• la configuration du bloc est chargée par `GetPlanningExportConfiguration`
• le lancement passe par `ExportPrePlanning`, puis le téléchargement réel par `DownloadPrePlanning`
• la semaine doit respecter un format ISO `AAAA-Wss`
• la génération hebdomadaire est ensuite déléguée au service `ExportPlanning(year, week)`
• le calcul interne de la période exportée correspond à une semaine ouvrée du lundi au vendredi

Export planning classique

Lorsque le site n'active pas l'export hebdomadaire, le même emplacement devient un bloc Planning et ouvre une fenêtre d'export sur période.

Version 1.14.0.305 du 13/04/2026 - export planning classique

Fonctionnellement, ce mode correspond à un export personnalisé du planning consulté :

• au moins un collaborateur doit être sélectionné
• la fenêtre propose par défaut la période visible dans le planning
• l'utilisateur renseigne une date début et une date fin
• les collaborateurs sélectionnés sont repris dans l'export
• les filtres actifs du planning sont repris dans l'export : métré, travaux, urgent, RDF et indisponibilités

La logique de sélection est plus large qu'un simple filtre "compris entre deux dates" :

• un rendez-vous est exporté dès qu'il croise la période demandée
• un rendez-vous commencé avant la période mais terminé pendant cette période reste donc exporté
• un rendez-vous commencé pendant la période et terminé après reste lui aussi exporté
• si plusieurs sélections remontent le même rendez-vous, iREN élimine les doublons

Le fichier généré restitue une lecture métier directement exploitable :

• date et heure de début du rendez-vous
• date et heure de fin
• collaborateur
• type de rendez-vous
• dossier
• assuré
• adresse du rendez-vous
• commentaire
• informations diverses

La colonne Informations diverses enrichit la lecture métier avec :

• le sous-type de rendez-vous ou le libellé d'occupation
• la présence d'un devis
• la présence d'une commande
• la présence d'une facture
• l'information de clôture du dossier
• la mention d'une transmission SINAPPS
• le titre du rapport lorsqu'il existe

Si aucun rendez-vous ne correspond à la demande, iREN génère malgré tout un fichier Excel avec un message explicite. L'utilisateur garde ainsi une trace claire du périmètre exporté, même lorsqu'il est vide.

Repères techniques :

• le basculement de l'interface entre Pré-planning et Planning est géré par `updatePlanningExportUI`
• la fenêtre de période est ouverte par `openClassicPlanningExportDialog`
• l'API `ExportPlanningClassic` exige au moins un collaborateur et une période valide
• si la date de fin est saisie sans heure, iREN l'étend jusqu'à la fin de journée
• les catégories exportées suivent les mêmes filtres que ceux utilisés à l'écran pour lire le planning

Créer un rendez-vous

La création d'un rendez-vous se fait depuis le planning en sélectionnant un créneau libre. iREN ouvre alors la fenêtre Nouveau rendez-vous.

• 

  Nouveau rendez-vous métré

• 

  Nouveau rendez-vous travaux

• 

  Nouveau rendez-vous urgent

• 

  Nouveau rendez-vous RDF

• 

  Nouvelle indisponibilité

Règles communes

Les règles suivantes structurent la création :

• pour tous les rendez-vous liés à un Dossier, il faut renseigner un dossier, un lieu et au moins un intervenant
• le planning propose les intervenants à partir de la sélection du panneau de gauche
• le lien Vérifier les distances aide à arbitrer l'affectation d'un collaborateur
• l'option Le RDV porte la couleur technicien permet d'harmoniser la lecture visuelle du planning
• l'option Mettre à jour l'état du dossier relie la pose du rendez-vous à l'avancement du Dossier
• les blocs SMS s'appuient sur la Gestion des SMS et sur les modèles de SMS

Repère technique : les contrôles de sauvegarde sont portés par l'API `SaveRDV`. Côté métier, iREN bloque notamment l'enregistrement d'un rendez-vous non indisponibilité si aucun intervenant n'est sélectionné ou si aucune adresse n'est renseignée.

Rendez-vous métré

Le rendez-vous métré est saisi sur un créneau simple avec une date, une heure de début et une heure de fin. Il demande :

• un type de rendez-vous métré
• un dossier
• un lieu
• un métreur

La fenêtre permet également de positionner le technicien en tant que métreur actif. Cette option a un impact de fonctionnement au-delà du seul planning.

Rendez-vous travaux

Le rendez-vous travaux reprend le même principe, mais sur une saisie début / fin. Il s'appuie sur :

• un type de rendez-vous travaux
• un dossier
• un lieu
• un technicien

Rendez-vous urgent

Le rendez-vous urgent reprend la même logique que les rendez-vous dossier, avec une saisie rapide centrée sur :

• le créneau
• le dossier
• le lieu
• le technicien

Sur l'environnement observé, la fenêtre urgente ne proposait pas de liste de sous-types dédiée.

Rendez-vous RDF

Le rendez-vous RDF fonctionne comme le rendez-vous travaux, avec une liste de types spécifique à l'activité RDF.

Indisponibilité

L'indisponibilité ne dépend pas d'un dossier. Elle repose sur :

• une date de début et une date de fin
• un titre
• un commentaire éventuel
• un ou plusieurs intervenants

L'indisponibilité peut aussi devenir un événement récurrent, en mode quotidien, hebdomadaire ou mensuel.

Repère technique : la fenêtre d'indisponibilité utilise une logique distincte des rendez-vous dossier et s'appuie sur les paramètres de récurrence transmis à `SaveRDV`.

Particularités de paramétrage

Le code du planning prévoit également un mode dossier anonyme. Ce fonctionnement dépend du paramétrage du site et des préférences retournées à l'ouverture du planning. Il n'était pas visible sur l'environnement de recette observé le 13/04/2026.

Consulter et modifier un rendez-vous

Un clic sur un rendez-vous ouvre sa fiche d'information.

• 

  Fiche d'un rendez-vous

• 

  Modification d'un rendez-vous

• 

  Suppression d'un rendez-vous

La fiche reprend les éléments utiles à la lecture métier :

• la référence du dossier
• la référence du sinistre
• l'assuré
• le lieu
• le ou les techniciens
• le commentaire

Depuis cette fiche, l'utilisateur peut :

• modifier le rendez-vous
• supprimer le rendez-vous

La suppression propose un motif d'annulation facultatif, ce qui permet de conserver une explication fonctionnelle de l'action réalisée.

Repère technique : la fenêtre s'appuie sur `GetEventDetails`, puis les modifications sont transmises à `UpdateRDV` ou `DeleteRDV`.

Déplacer, redimensionner et gérer une récurrence

Le planning ne modifie pas silencieusement les créneaux existants. Lorsqu'un rendez-vous est déplacé ou que sa durée est modifiée, iREN demande une confirmation.

• 

  Confirmation d'un déplacement

• 

  Confirmation d'une modification de durée

• 

  Modification d'une récurrence d'indisponibilité

Fonctionnellement :

• un déplacement compare l'ancien créneau et le nouveau créneau avant validation
• une modification de durée compare la plage avant / après
• la récurrence concerne les indisponibilités récurrentes et permet d'agir sur toute la série

Repères techniques :

• le planning bloque les chevauchements visuels et de sélection dans le calendrier
• les confirmations de déplacement et de redimensionnement précèdent l'appel à `UpdateRDV`
• la modification d'une récurrence d'indisponibilité s'appuie sur `UpdateIndispoRecurrence`

Règles de gestion à retenir

Pour un usage quotidien, les règles métier suivantes sont les plus importantes :

• l'agenda reste vide tant qu'aucun intervenant n'est sélectionné
• les filtres intervenants et types de rendez-vous se cumulent
• les rendez-vous dossier exigent une adresse et un intervenant
• l'indisponibilité ne repose pas sur un dossier et peut devenir récurrente
• la taille des zones influe sur la précision de travail du planning
• les préférences du site peuvent masquer certains jours ou certaines plages horaires
• selon le paramétrage du site, la zone d'export bascule entre pré-planning hebdomadaire et export planning classique
• l'export planning classique reprend les collaborateurs cochés et les filtres actifs
• le pré-planning hebdomadaire repose d'abord sur la semaine choisie et sur le paramétrage du site

Références utiles

Pour prolonger la lecture :

• Page d'accueil iREN
• Dossier
• Etat dossier
• Gestion des SMS
• Modèles de SMS
• Annuaire
• Équipes planning

Repères techniques principaux :

• URL fonctionnelle : `/iREN/Planning_v2`
• page de support : `Vues_iREN/Planning/iREN_Planning.aspx`
• API métier : `/api/Planning`