Guide de l'utilisateur MultiDatePick

1. Les trois composants : lequel utiliser

MultiDatePick fournit trois Lightning Web Components sur une base commune. Choisissez celui qui correspond à vos données.

Comparaison des fonctionnalités

Les fonctionnalités s'additionnent. Tout ce que propose Date se retrouve dans Date Time et Booking. Date Time ajoute les heures. Booking ajoute les ressources et la capacité.

2. Formes d'enregistrement : laquelle utiliser

Une forme d'enregistrement décrit comment une sélection devient des enregistrements. Elle résulte de trois choix indépendants, et toutes les combinaisons fonctionnent.

L'assistant de configuration nomme six formes : un enregistrement par date, un par plage de dates, un par bloc horaire, parent plus sous-blocs, ressource unique et plusieurs ressources.

Exemples concrets : répondez aux 3 questions

Répondez à trois questions par scénario pour trouver la bonne forme. L'assistant de configuration pose les trois mêmes.

La grille : toutes les combinaisons

Choisissez la ligne selon vos besoins en heures et en ressources. La colonne dépend du fait que End Date Field API Name soit renseigné ou non. Chaque case correspond à une configuration valide.

En résumé : toute combinaison des trois choix fonctionne. Si votre scénario ne correspond à aucun modèle nommé, réglez chaque choix séparément et le composant fait le reste.

3. Présentation de l'assistant de configuration

L'assistant de configuration enregistre une configuration une seule fois. Saisissez son nom dans Config Name sur n'importe quelle page ou n'importe quel écran de flux, et cet emplacement l'utilise. Modifiez la configuration et tous les emplacements suivent.

1. 1 Nom & type
2. 2 Objet & champs
3. 3 Champs temporels
4. 4 Statut & affichage
5. 5 Vérifier & enregistrer

Choisir un point de départ

L'onglet Créer propose deux parcours. Guidez-moi pose trois questions et choisit le composant et la forme. Configurer toutes les propriétés ouvre tous les paramètres. Deux autres onglets se trouvent à côté : Configurations existantes pour modifier une configuration enregistrée, et Importer pour en coller une depuis la Config Library.

Étape 1 : Nom & type

Choisissez le composant (Date, Date Time ou Booking) et nommez la configuration. Ce nom est celui que vous saisirez ensuite dans Config Name. Cette étape définit aussi les vues : la vue par défaut, les vues proposées par le sélecteur, et les options de la Chronologie et de l'Agenda.

Étape 2 : Objet & champs

L'étape principale. Choisissez l'objet qui contient les enregistrements, son champ date et le champ de relation vers le parent. Des champs facultatifs ajoutent les plages, les ressources, la capacité, les sous-blocs et les dates bloquées. Les configurations Booking définissent aussi ici l'objet ressource, le champ de capacité et les heures ouvrables.

Étape 3 : Champs temporels

Date Time et Booking uniquement. Associez les champs d'heure de début et de fin, puis définissez l'intervalle horaire (tout intervalle fonctionne ; 15, 30 ou 60 minutes sont courants), l'heure la plus tôt et la plus tardive, le mode d'affichage et ce qui se passe en cas de conflit.

Étape 4 : Statut & affichage

Champ de statut et couleurs, statuts à masquer, statuts que les utilisateurs peuvent choisir, champs au survol, mode édition, nom des enregistrements, libellés des boutons, taille du calendrier et limites comme Max Dates Allowed.

Étape 5 : Vérifier & enregistrer

Vérifiez le récapitulatif, essayez l'aperçu en direct, puis cliquez sur Enregistrer la configuration. L'assistant déploie la configuration pour vous en 30 à 60 secondes. Ajoutez une description facultative à la fin.

Configurations existantes et import

Les configurations enregistrées sont listées dans Configurations existantes : cliquez sur l'une d'elles pour la modifier ou l'exporter. L'onglet Importer accepte le JSON de n'importe quelle carte de la Config Library, ou un export provenant d'une autre org.

4. Ensembles d'autorisations & accès

Le package fournit quatre ensembles d'autorisations. Attribuez-les dans Configuration, Ensembles d'autorisations.

Les composants s'exécutent avec les autorisations de chaque utilisateur. Les utilisateurs doivent donc aussi avoir accès à vos objets et champs :

• Objets : Lecture et Création sur l'objet où les enregistrements sont sauvegardés, plus Lecture sur chaque objet ressource, fermeture ou enfant que lit le calendrier.
• Champs, lecture : chaque champ affiché par le calendrier (date, statut, champs au survol).
• Champs, modification : chaque champ qu'il écrit (date, heures, statut, seconde liste de sélection, champ nom, référence au parent). Un champ que l'utilisateur ne peut pas modifier fait échouer l'enregistrement, même si la lecture fonctionne.
• Enregistrements référencés : au moins Lecture sur le parent et la ressource vers lesquels pointe le nouvel enregistrement.

Chaque message d'erreur et sa cause figurent dans Dépannage : erreurs d'accès. Les sites invités demandent quelques étapes de plus : voir Pages publiques pour invités.

5. Click to Save ou enregistrement géré par le flux

Il existe deux façons d'enregistrer. Choisissez celle qui convient à l'emplacement.

Click to Save : les quatre paramètres

L'assistant de configuration les renseigne. Quand les quatre ont une valeur, le bouton Enregistrer apparaît.

Quel enregistrement parent une page utilise, et quand le choisir plutôt dans un flux, est expliqué dans Pages d'application, d'accueil & Experience.

Enregistrement géré par le flux : les sorties

Laissez les quatre paramètres vides. Le bouton Enregistrer se masque et la sélection sort par ces sorties de flux :

Transmettez le JSON à Parse Date Entries from JSON. L'action renvoie une liste que vous pouvez parcourir avec une Boucle, avec sur chaque élément une date de début, une date de fin, une heure de début, une heure de fin et l'Id de la ressource. Pas à pas : Recettes de flux.

L'enregistrement ne fait qu'ajouter

Click to Save ne fait que créer de nouveaux enregistrements. Désélectionner une date ne supprime jamais un enregistrement sauvegardé : un mauvais clic ne peut donc pas faire perdre de données. Pour modifier ou supprimer des enregistrements, utilisez le mode édition ou la liste associée.

6. Couleurs de statut & mode édition

Couleurs de statut et filtrage

Colorez les enregistrements selon n'importe quelle liste de sélection de votre objet, masquez certaines valeurs et limitez ce que les utilisateurs finaux peuvent choisir.

Mode édition

Activez Enable Edit Mode (Activer le mode édition) et un bouton Modifier apparaît. En mode édition, les utilisateurs peuvent :

• Voir les enregistrements existants sous forme de cartes avec leur date et leur statut
• Cliquer sur des dates pour ajouter leurs enregistrements à la sélection à modifier
• Changer la date, les heures, la ressource ou le statut : l'enregistrement est mis à jour
• Supprimer avec une confirmation en deux clics, pour que rien ne parte par accident

7. Vues : cinq mises en page, un composant

Chaque composant propose cinq mises en page. Elles lisent les mêmes enregistrements avec les mêmes correspondances de champs, appliquent les mêmes règles de conflit, dates bloquées et heures ouvrables, et enregistrent de la même façon. Changer de vue change l'apparence des enregistrements, jamais leur signification.

Les cinq vues, et la question à laquelle chacune répond

Paramètres

Une vue différente sur chaque page

La vue se règle sur chaque emplacement : les mêmes enregistrements peuvent donc avoir une apparence différente selon l'endroit où ils s'affichent. Une seule installation, un seul jeu de correspondances de champs.

Le mode édition fonctionne dans toutes les vues

Avec Enable Edit Mode activé, le bouton de modification apparaît dans toutes les vues. Cliquez sur un enregistrement dans la Chronologie, la Semaine ou l'Agenda pour l'ajouter à la sélection à modifier, exactement comme une date du calendrier mensuel. Un changement de statut groupé depuis la Chronologie fonctionne comme depuis le calendrier.

Chronologie : lignes repliées

Quand une ressource a des réservations qui se chevauchent, sa ligne se replie en une seule bande avec une pastille N à la fois. Une flèche de dépliage ouvre un couloir par réservation. Les lignes repliées acceptent toujours le glisser, le survol et le clic.

Chronologie : replanifier par glisser-déposer

Avec Enable Edit Mode activé, les barres de la Chronologie se déplacent à la souris. Saisissez le milieu pour décaler une réservation sur d'autres jours, un bord pour changer son début ou sa fin. La barre montre où elle va atterrir et s'enregistre dès que vous relâchez. En zoom Jour, les mêmes gestes changent les heures.

Planifiez des personnes, pas seulement des salles

Resource Object API Name accepte n'importe quel objet. Choisissez User : la Chronologie devient un planning d'équipe, la Semaine une grille de postes et l'Occupation un tableau de bord de la capacité de l'équipe.

• User n'a pas de champ de capacité standard. Ajoutez-en un personnalisé (par exemple Daily Capacity) pour voir l'Occupation en pourcentages.
• Associez Business Hours Start Field (Champ Début des heures ouvrables) et Business Hours End Field (Champ Fin des heures ouvrables) à des champs de User : la grille Semaine suit alors les horaires de chaque personne.

La Config Library propose deux exemples prêts à l'emploi : Planification de la capacité des équipes et Planning des postes du personnel.

8. Réservation de ressources & capacité (composant Booking)

Ressource unique

L'utilisateur choisit une ressource dans une liste déroulante. La grille horaire charge les réservations et la capacité de cette ressource.

Plusieurs ressources

Activez Allow Multiple Resources et la liste déroulante devient des cases à cocher. La grille ne montre que les créneaux libres sur toutes les ressources cochées, et Enregistrer les réserve toutes en une fois.

Capacité

Plusieurs réservations peuvent partager un créneau, avec des badges 3/5 en temps réel. Un créneau complet n'accepte plus de réservation.

Conflits

Conflict Behavior décide de ce qui se passe quand un créneau choisi est déjà pris. Conflict Look-Ahead Days fixe jusqu'où vérifier (360 jours par défaut).

Une fermeture l'emporte toujours. Rien ne s'enregistre sur un créneau bloqué, même avec Allow.

9. Limiter ce que les utilisateurs sélectionnent

Plafonnez ce qu'une personne peut choisir, en nombre de dates ou de créneaux.

10. Bloquer des dates, des heures & des ressources (fermetures)

Tout calendrier peut lire des fermetures depuis un autre objet et griser les dates, créneaux ou ressources concernés : les utilisateurs ne réservent que lorsque vous êtes ouvert. Faites pointer quelques paramètres sur l'objet des fermetures et le composant fait le reste. Le blocage de journées entières fonctionne sur les trois composants. Le blocage d'heures et de ressources nécessite la grille horaire de Date Time ou Booking.

Bloquer ou masquer : quelle différence ?

Les deux se ressemblent mais font l'inverse l'un de l'autre. Bloquer retire de la disponibilité : le créneau s'affiche mais ne peut pas être réservé. Masquer retire des enregistrements de l'affichage, ce qui libère leurs créneaux.

Les paramètres des dates bloquées

Trois niveaux de blocage

1. Journée entière : une fermeture sans heures grise toute la date. Sur les trois composants. Une date fermée reste fermée, même si elle a déjà des réservations.
2. Partie de la journée : une fermeture avec une heure de début et de fin bloque uniquement ces créneaux. Le reste de la journée reste réservable. Les créneaux bloqués apparaissent dès qu'une date est sélectionnée.
3. Une ressource : une fermeture qui pointe vers une ressource ne ferme que celle-ci. Dans une vue à ressource unique, le créneau est barré. Dans la vue combinée, il reçoit un petit marqueur dans le coin et reste réservable sur les ressources ouvertes.

Vous utilisez la grille horaire ? Il vous faut des blocages sur une partie de la journée. Les blocages de journée entière conviennent aux sélecteurs de dates seules.

Deux modèles pour l'objet des fermetures

• Le même objet, marqué par un statut : faites pointer Blocked Dates Object sur votre objet de réservation et filtrez sur Status = Cancelled, pour que les réservations annulées servent aussi de fermetures. C'est le plus simple, mais tous les calendriers de cet objet les partagent. Voir la configuration Prise de rendez-vous avec jours fériés dans la Config Library.
• Un objet de fermeture dédié : un objet Office Closure avec une date, des heures de début et de fin facultatives, un champ Region et une référence facultative à une ressource. Chaque calendrier filtre sur sa région, et une fermeture peut cibler une seule ressource. Voir la configuration Fermetures de ressources à l'heure près.

Pour que chacun bloque son propre temps (un responsable qui bloque une matinée, par exemple), placez un composant Date Time qui enregistre dans l'objet des fermetures sur une page interne ou un site.

Comportement des créneaux bloqués

• Apparence : un créneau entièrement fermé est barré et grisé. Un créneau fermé pour une partie seulement des ressources choisies reçoit un marqueur dans le coin.
• Sélection : un créneau entièrement fermé ne peut être ni cliqué ni survolé en glissant.
• Enregistrement : rien ne s'enregistre sur une ressource, une date et une heure fermées. Avec plusieurs ressources, seule la ressource fermée est écartée ; les autres sont réservées normalement.

Une table de fermetures, plusieurs calendriers

Ajoutez un champ d'étiquette à l'objet des fermetures (Region, Location, Building) et le même champ sur vos ressources. Chaque calendrier utilise alors Resource Filter Field / Value (Champ filtre de ressource / Valeur du filtre de ressource) pour afficher ses propres ressources et Blocked Dates Filter Field / Value (Champ filtre / Valeur de filtre des dates bloquées) pour lire ses propres fermetures.

11. Pages publiques pour invités (Experience Cloud)

Placez un composant sur un site Experience Cloud et n'importe qui peut réserver sans se connecter. Faites les cinq étapes avant de tester en tant qu'invité.

1. Autorisations sur les objets. Donnez à l'utilisateur invité du site la Lecture, plus la Création si les invités soumettent quelque chose, sur chaque objet. Salesforce n'autorise jamais les invités à modifier ou supprimer des enregistrements : réservez les pages de modification, d'annulation et de suppression aux utilisateurs connectés.
2. Sécurité au niveau du champ sur chaque champ utilisé par le composant, y compris les champs d'heures ouvrables des ressources et les champs d'heure des fermetures. Un seul champ manquant fait échouer la requête des ressources ou des fermetures.
3. Une règle de partage invité (Lecture) pour que l'invité voie les enregistrements. Le paramètre par défaut externe à l'échelle de l'organisation de l'objet doit être Privé pour que la règle s'applique. Une règle déployée sous forme de métadonnées demande un clic sur Recalculer dans Configuration, Paramètres de partage.
4. L'ensemble d'autorisations MultiDatePick - Guest sur l'utilisateur invité du site. Il donne accès aux classes Apex par lesquelles le composant charge ses données.
5. Activez le site. Publier et activer sont deux étapes distinctes.

• Quel enregistrement voient les invités : une page publique utilise Static Parent Record Id, donc tous les invités réservent sur le même parent (un bureau, un lieu ou une ressource). Pour un enregistrement par visiteur, pilotez-le depuis un flux avec un paramètre d'URL. De vrais calendriers par utilisateur nécessitent des utilisateurs connectés.
• Contacts et comptes : Salesforce limite fortement l'accès des invités à ces objets. Faites réserver les invités sur un objet personnalisé, ou utilisez un site authentifié.
• Plusieurs composants sur une même page : ils ne se synchronisent pas en direct. Ajoutez une invitation à actualiser entre eux pour qu'un blocage fait dans l'un apparaisse dans le suivant.

Les étapes de placement sont décrites dans Pages d'application, d'accueil & Experience. Un site complet en exemple se trouve dans Réservation sur Experience Cloud.

12. Pièges fréquents (FAQ)

Une bannière, un bouton Enregistrer absent ou un calendrier vide ? Le Dépannage montre chaque message avec une capture d'écran et la solution.

Mes couleurs de statut ne s'appliquent pas

Vérifiez trois choses. (a) Status Field contient-il exactement le nom d'API de la liste de sélection ? Il est sensible à la casse. (b) Status Colors respecte-t-il le format Value:#hex, Value:#hex sans guillemets ? 'Confirmed':'#22C55E' le casse sans aucun message. (c) Les enregistrements ont-ils réellement une valeur dans cette liste de sélection ?

Les enregistrements sont sauvegardés avec des noms inattendus

Vérifiez Record Name Field (Champ Nom d'enregistrement) : si le champ est court, les noms longs sont tronqués. Vérifiez Append Date to Record Name (Ajouter date/heure au nom) : activé, il ajoute la date et l'heure sélectionnées à chaque nom.

Comment masquer les enregistrements Cancelled de la grille de capacité ?

Mettez Ignored Statuses sur Cancelled, ou une liste comme Cancelled,Rejected. Ils disparaissent du calendrier et du calcul de la capacité.

Quelle différence entre bloquer et masquer ?

Bloquer (fermetures) laisse une date, une heure ou une ressource visible mais non réservable : jours fériés, maintenance, salle fermée. Masquer retire du calendrier et de la capacité des enregistrements comme ceux en Cancelled, ce qui libère le créneau. Voir Bloquer ou masquer.

Le bouton de modification n'apparaît pas

Activez Enable Edit Mode. C'est la seule condition, sur les trois composants. Un Status Field est facultatif : il ajoute seulement une liste déroulante de statut dans l'éditeur. Si le bouton manque toujours, Enable Edit Mode est désactivé sur la page ou dans la configuration.

Je ne veux que certaines ressources (les salles, pas le matériel)

Utilisez Resource Filter Field et Resource Filter Value. Une valeur : champ Active__c, valeur true. Plusieurs valeurs (OU) : North,South. Plusieurs champs (ET) : champ Type__c;Active__c, valeur Conference Room;true.

Date Time affiche toujours un seul sélecteur d'heure commun

Le paramètre à utiliser est Time Display Mode (Mode d'affichage des heures) : Grid ou Dropdown. En mode Grid, toutes les dates partagent la grille. Pour une heure différente par date, choisissez Dropdown et activez Allow Different Times Per Date (Autoriser des heures différentes).

Comment passer de l'enregistrement géré par le flux à Click to Save ?

Renseignez Parent Record Id, Child Object API Name, Date Field API Name et Relationship Field API Name. Supprimez l'action Parse Date Entries from JSON et la boucle qui créait les enregistrements. C'est désormais le bouton Enregistrer du composant qui les écrit.

J'obtiens une notification d'erreur sans détail

Ouvrez la console de développement du navigateur et cherchez les lignes qui commencent par [MDP:ERROR]. L'erreur complète y est toujours journalisée, même quand la notification est courte.

13. Recettes de flux

Tout se construit dans Flow Builder. Sans Apex.

Parcourir les dates sélectionnées dans une boucle

1. Ajoutez un écran avec le composant Date Time. Laissez vides les paramètres de Click to Save.
2. Après l'écran, ajoutez l'action Parse Date Entries from JSON. Passez-lui Dates With Times JSON (Output).
3. Parcourez la liste renvoyée par l'action avec une Boucle. Chaque élément a une date de début, une date de fin, une heure de début et une heure de fin.
4. Dans la boucle, affectez les valeurs à une variable d'enregistrement et ajoutez-la à une collection. Créez les enregistrements en une seule fois, après la boucle.

Remonter la première et la dernière date sur le parent

Vous voulez que le parent affiche la date enfant la plus ancienne et la plus récente ? Choisissez la méthode sans code adaptée à vos données.

D'autres modèles de flux : Guide des flux d'écran.

14. Correspondance des objets & champs

Chaque page de composant propose un schéma complet de correspondance des objets et des champs :

• Date : correspondance des objets
• Date Time : correspondance des objets
• Booking : correspondance des objets

Les composants fonctionnent avec n'importe quel objet. Les objets d'exemple du package (Schedule, Event, Resource, Sub Block) ne sont que des valeurs par défaut. Faites pointer les paramètres sur vos propres objets, personnalisés ou standard, qui ont les bons champs.

15. Référence de toutes les propriétés

Chaque paramètre des trois composants, sous le libellé affiché dans Lightning App Builder, Experience Builder et Flow Builder. Le nom d'API figure sous chaque libellé.

16. Sécurité & accessibilité

• A passé la revue de sécurité Salesforce AppExchange.
• 100 % natif. Vos données restent dans votre org Salesforce. Aucun serveur externe, aucun appel sortant. Voir Confiance & sécurité.
• Toujours vos autorisations. Chaque lecture et chaque enregistrement s'exécutent avec les accès de l'utilisateur : autorisations sur les objets, sécurité au niveau du champ et partage s'appliquent à chaque enregistrement.
• Accessible. WCAG 2.1 AA, testé avec axe-core. VPAT 2.5 complet.
• 9 langues : anglais, espagnol, français, allemand, japonais, hindi, portugais (Brésil), italien, chinois (simplifié).

17. Des questions ou des bugs ?

Il manque quelque chose dans ce guide, ou un élément ne fonctionne pas ? Écrivez à support@multidatepick.com.