Calendrier

Aperçu

Le composant Avonni Calendar offre un excellent moyen d'afficher et de gérer des événements, des tâches, des plannings et plus encore directement au sein de votre site Salesforce Experience Cloud. Son design intuitif et ses fonctionnalités personnalisables améliorent l'expérience utilisateur et les capacités de planification.

Se connecter aux données Salesforce

Cette étape essentielle dans la configuration de votre composant Avonni Calendar établit la connexion entre vos éléments de calendrier et les données pertinentes de votre environnement Salesforce.

La source de données détermine quelles informations votre calendrier affichera.

Vous avez deux options pour utiliser la source de données

• Manuel :

  • Ajoutez des événements et des ressources directement au sein de l'interface du calendrier.

  • Utile pour les événements ponctuels ou lorsque vous n'avez pas besoin de lier les données à Salesforce.

• Requête :

  • Récupérez les informations directement depuis vos données Salesforce.

  • Créez une requête personnalisée pour afficher les données de n'importe quel objet Salesforce sur le calendrier.

  • Idéal lorsque votre calendrier doit refléter des informations à jour provenant de Salesforce.

Configuration de la source de données par requête

Pour garantir que votre Avonni Calendar affiche les informations les plus pertinentes, vous devrez configurer l'origine de ses données. Ce processus consiste à sélectionner l'objet Salesforce approprié, et éventuellement à appliquer des filtres, des regroupements et un tri pour affiner les résultats.

Décomposons les étapes :

• Sélection de l'objet : Commencez par choisir l'objet Salesforce spécifique (par ex., Comptes, Opportunités, objets personnalisés, etc.) qui contient les données que vous souhaitez afficher sur votre tableau Kanban.

• Filtrage optionnel : Si vous souhaitez n'afficher qu'un sous-ensemble de données de l'objet sélectionné, utilisez la fonctionnalité de filtrage pour définir des conditions spécifiques. Par exemple, vous pouvez filtrer pour n'afficher que les opportunités « Ouvertes » ou les comptes d'une certaine région.

• Regroupement (optionnel) : Regroupez vos données pour organiser efficacement votre tableau Kanban. Par exemple, regrouper les opportunités par « Étape » peut créer des colonnes pour « Prospection », « Négociation », etc.

• Tri : Sélectionnez un champ « Trier par » et la direction (ascendante ou descendante) pour déterminer l'ordre d'affichage des cartes Kanban.

• Champs supplémentaires : Si vous devez inclure des champs dans votre Kanban qui ne sont pas directement utilisés pour l'affichage ou les interactions, ajoutez-les dans la section « Champs supplémentaires ». Ceci est particulièrement utile pour les champs que vous souhaitez rendre consultables via la barre de recherche du Kanban.

Mappages de données

Les mappages de données sont la clé pour s'assurer que les événements issus de vos enregistrements Salesforce s'affichent correctement sur votre Avonni Calendar. Pensez-y comme à la traduction des informations de Salesforce dans une langue que votre calendrier comprend.

Mappages essentiels

Voici une répartition des mappages les plus courants que vous devrez configurer :

• Titre : Le champ Salesforce contenant le nom ou le titre de l'événement (par exemple, « Subject » sur l'objet standard Event).

• Nom de la ressource : Le champ indiquant à quelle ressource l'événement est attribué (par exemple, un champ « Room » pour les réservations de salle ou un champ « Owner » pour les rendez‑vous commerciaux). Si cela est laissé vide, tous les événements apparaîtront ensemble.

• De : Le champ Salesforce qui contient la date et l'heure de début de l'événement (par exemple, « StartDateTime »).

• À : Le champ Salesforce qui contient la date et l'heure de fin de l'événement (par exemple, « EndDateTime »).

Exemple :

Si vous créez un calendrier de réservation de salles de réunion, vous pourriez mapper les champs suivants :

• Titre : Sujet de la réunion

• Nom de la ressource : Nom de la salle

• De : Début prévu

• À : Fin prévue

Paramètres

Affichage sélectionné

Avonni Calendar propose trois formats d'affichage distincts pour répondre à différentes préférences d'organisation et de planification. Chaque format offre une manière unique de visualiser et d'interagir avec vos événements et ressources.

Variante Timeline

Avonni Calendar propose deux manières d'afficher votre vue Timeline :

• Timeline horizontale :

  • Les événements sont disposés horizontalement à travers l'écran, la timeline s'étendant de la gauche vers la droite.

  • Idéal pour visualiser des plannings sur une période plus longue (par exemple, semaines ou mois).

• Timeline verticale :

  • Les événements sont empilés verticalement, la timeline s'étendant du haut vers le bas.

  • Cette vue convient bien pour voir des plannings détaillés sur une journée ou quelques jours.

Affichages masqués

L'option « Affichages masqués » empêche les utilisateurs de sélectionner certaines vues lorsqu'ils interagissent avec l'Avonni Calendar.

Zoom pour adapter

Le paramètre « Zoom pour adapter » ajuste automatiquement la vue du calendrier afin que tous les événements programmés tiennent à l'écran sans faire de défilement. Voici comment cela fonctionne et quand c'est le plus utile :

Comment cela fonctionne

• Le calendrier réduira ou agrandira son échelle de temps pour faire tenir tous les événements dans la vue sélectionnée (jour, semaine, etc.).

Avantages

• Aperçu rapide : Voir tous vos événements programmés d'un coup d'œil.

• Pas de défilement : Éviter de faire défiler vers le haut et le bas pour trouver des événements.

Points à garder à l'esprit

• Avec de nombreux événements ou sur des écrans très petits, la vue compressée peut rendre les détails individuels des événements plus difficiles à lire.

Options de la barre d'outils

• Titre de la barre d'outils : Définissez un titre personnalisé pour l'en-tête de votre calendrier. Cela aide les utilisateurs à comprendre l'objectif du calendrier (par exemple, « Planning de l'équipe commerciale », « Événements à venir », etc.).

• Masquer la barre d'outils : Vous pouvez masquer la barre d'outils entière pour obtenir un look plus épuré ou maximiser l'espace d'affichage du calendrier.

Fonctionnalités d'Actions

Le composant Avonni Calendar va au‑delà de la simple affichage des événements ; il propose plusieurs façons pour vos utilisateurs d'interagir directement avec lui et de déclencher d'autres actions.

Types d'actions

• Actions Nouvel Événement : Personnalisez ce qui se passe lorsque les utilisateurs glissent leur curseur sur le calendrier pour planifier un nouvel événement. Par exemple, vous pouvez ouvrir automatiquement un formulaire de création d'événement.

• Actions d'en-tête : Ajoutez des boutons personnalisés à la barre d'outils du calendrier. Ces boutons peuvent être programmés pour déclencher n'importe quelle interaction disponible listée ci‑dessous.

• Actions du menu contextuel : Ces boutons apparaissent lorsqu'un utilisateur fait un clic droit sur un événement ou ouvre les détails de l'événement. Configurez ces boutons pour permettre des actions telles que modifier, supprimer ou déclencher des processus supplémentaires liés à l'événement.

Interactions disponibles

Le composant Avonni Calendar propose plusieurs interactions qui peuvent être déclenchées par les actions décrites ci‑dessous :

• Afficher un toast: Afficher un bref message de notification à l'utilisateur, confirmant une action ou fournissant un retour.

• Naviguer: Rediriger l'utilisateur vers une page différente au sein de votre Experience Cloud ou vers un site externe.

• Ouvrir une alerte modale: Présenter une fenêtre contextuelle contenant des informations importantes ou une demande de confirmation.

• Ouvrir une confirmation: Afficher une boîte de dialogue de confirmation demandant à l'utilisateur de vérifier une action (par exemple, la suppression d'un événement).

• Ouvrir la boîte de dialogue Flow: Lancer un Flow Salesforce, vous permettant d'automatiser des processus complexes ou de guider les utilisateurs à travers plusieurs étapes.

• Rafraîchir la requête : Mettre à jour l'affichage du calendrier avec les dernières données provenant de Salesforce.

Comment implémenter

Pour configurer ces actions et interactions, vous travaillerez dans les paramètres du composant Avonni Calendar dans Experience Cloud Builder. Chaque type d'action (Nouvel Événement, En‑tête, Menu contextuel) disposera d'une section où vous pourrez définir l'interaction à déclencher.

Avatar

La section Avatar vous permet d'ajouter une photo ou une image à l'en‑tête de votre Avonni Calendar. Cela peut aider à personnaliser le calendrier et fournir un identifiant visuel.

Contrôle de la plage temporelle

Les paramètres de plage temporelle d'Avonni Calendar offrent une flexibilité pour visualiser les événements et gérer votre planning. Choisissez parmi ces options :

• Vue Jour : Vous pouvez vous concentrer sur une seule journée ou la personnaliser pour voir plusieurs jours consécutifs (par exemple, voir une semaine de travail de 4 jours).

• Vue Semaine : Voir le planning d'une semaine complète en un coup d'œil.

• Vue Mois : Obtenir une vue d'ensemble plus large du mois, avec la possibilité d'afficher 2 à 4 semaines à la fois ou un nombre personnalisé de semaines.

Comment configurer les plages temporelles

Chaque plage temporelle (Jour, Semaine, Mois) possède ses paramètres :

• Étiquette : Donnez à votre plage temporelle un nom descriptif (par exemple, « Semaine de travail »).

• Nom de l'icône : Sélectionnez une icône visuelle pour aider à identifier rapidement la plage temporelle.

• Unité : Choisissez si cette plage temporelle représente des jours, des semaines ou des mois.

• Étendue : Définissez le nombre d'unités à afficher (par exemple, 5 jours, 2 semaines).

En-têtes de la timeline (vue Timeline uniquement)

Affinez les en‑têtes de votre vue Timeline pour afficher les informations les plus importantes pour vous, telles que les numéros de semaine, les dates ou les mois.

Temps disponible

La section Temps disponibles propose plusieurs options pour personnaliser les plages horaires qui apparaissent sur votre calendrier. Cette fonctionnalité est utile pour se concentrer sur des périodes d'intérêt spécifiques. Voici les options disponibles :

Affichage des événements

La section Affichage des événements propose plusieurs options pour personnaliser l'esthétique visuelle de vos événements sur le calendrier.

Voici les options disponibles :

• Thème: Cette option vous permet de choisir un thème visuel pour vos événements. Vous pouvez sélectionner parmi plusieurs thèmes prédéfinis, tels que par défaut, transparent, ligne, creux ou arrondi, chacun offrant un style visuel unique pour correspondre à votre préférence personnelle ou à l'identité de votre marque.

• Palette: Cette fonctionnalité vous permet d'assigner différentes couleurs d'une palette choisie à chaque ressource. Une palette de couleurs est un ensemble de couleurs qui assure une utilisation cohérente des couleurs entre les différentes ressources. Cela aide à différencier visuellement et à identifier rapidement les différents types de ressources sur votre calendrier.

• Champs du popover: Lorsque l'utilisateur survole un événement, ces champs seront affichés dans une petite fenêtre contextuelle (ou un « popover »). Cela permet aux utilisateurs de voir les détails essentiels de l'événement sans cliquer dessus.

Filtre

Personnalisez la manière dont les utilisateurs affinent les événements affichés sur votre Avonni Calendar.

• Masquer le filtre Ressources : Choisissez cette option pour supprimer le filtre qui permet aux utilisateurs de voir les événements en fonction de ressources spécifiques (par exemple, personnes, salles, équipements).

• Masquer le sélecteur de date : Sélectionnez ceci pour supprimer l'icône du calendrier dans l'en‑tête qui permet aux utilisateurs de naviguer vers une date spécifique.

• Type (Horizontal, popover, panneau gauche, panneau droit, vertical) : Déterminez le style visuel et le placement de la section de filtre :

  • Horizontal : Une barre en travers du haut du calendrier.

  • Popover : Un filtre compact qui s'ouvre lorsqu'on clique dessus.

  • Panneau gauche/droite : Un panneau latéral pour les options de filtre.

  • Vertical : Une liste verticale d'options de filtre

Recherche

• Afficher la recherche : Activez cette option pour ajouter une zone de recherche en haut de votre Avonni Calendar, permettant aux utilisateurs de trouver rapidement des événements spécifiques.

• Espace réservé : Ajoutez une courte phrase (par exemple, « Rechercher des événements... ») pour guider les utilisateurs sur ce qu'ils peuvent rechercher dans le calendrier.

• Position (gauche, droite, centre, remplissage) : Choisissez où placer la zone de recherche dans l'en‑tête du calendrier pour une meilleure mise en page visuelle.

Apparence du style

Taille

• Largeur : Définit la largeur horizontale du calendrier. Vous pouvez utiliser des valeurs fixes (pixels, pourcentages) ou laisser le calendrier s'adapter en fonction de son conteneur.

• Hauteur : Ce paramètre définit la hauteur verticale du calendrier. Comme pour la largeur, vous pouvez utiliser des paramètres de hauteur fixes ou flexibles.

• Débordement : Détermine comment le calendrier gère le contenu qui dépasse ses dimensions. Les options peuvent inclure :

  • Visible : Le contenu dépasse à l'extérieur du calendrier.

  • Masqué : Le contenu est coupé aux bords du calendrier.

  • Défilement : Le calendrier obtient des barres de défilement si le contenu déborde.

Barre d'outils

• Couleur de fond : Ce paramètre définit la couleur d'arrière‑plan de la barre d'outils du calendrier (la zone contenant généralement les boutons de navigation, la sélection de vue, etc.).