> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-calendar.md).

# AX - Calendrier

## Aperçu

**AX - Calendrier** est un composant Experience Cloud qui affiche les enregistrements Salesforce sous forme d’événements dans une vue calendrier interactive sur les pages des sites Experience.

Utilisez-le pour afficher aux utilisateurs du portail leurs rendez-vous, leurs tâches planifiées, leurs inscriptions à des événements, les échéances de projets ou tout autre enregistrement basé sur une date. Les utilisateurs peuvent afficher les événements par mois, semaine, jour ou en format agenda, et cliquer sur les événements pour voir les détails ou accéder aux enregistrements.

Idéal pour la planification des rendez-vous clients, les calendriers d’événements, les vues de réservation de services, les chronologies de projet, ou partout où les utilisateurs du portail doivent voir leurs activités datées sous un format de calendrier visuel.

## Configuration

### Source de données

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

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

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-7fb68a719d452a22f8c6e08008334783620570c5%2F2024-04-23_08-55-49.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="126">Option</th><th>Description</th><th>Meilleur cas d’utilisation</th></tr></thead><tbody><tr><td><strong>Manuel</strong></td><td>Saisissez manuellement les événements et les ressources directement dans l’interface du calendrier.</td><td>Événements ponctuels, ou situations où vous n’avez pas besoin que le calendrier soit lié à vos données Salesforce.</td></tr><tr><td><strong>Requête</strong></td><td>Récupérez automatiquement les informations des événements et des ressources à partir de vos données Salesforce. Vous pouvez créer une requête personnalisée pour afficher les données de n’importe quel objet Salesforce.</td><td>Lorsque vous voulez que votre calendrier affiche toujours les informations les plus à jour de vos enregistrements Salesforce.</td></tr></tbody></table>

* **Manuel :**
  * Ajoutez des événements et des ressources directement dans 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 dans le calendrier.
  * C’est idéal lorsque votre calendrier doit refléter des informations à jour provenant de Salesforce.

#### Configuration de la source de données de 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 le bon objet Salesforce et, éventuellement, à appliquer des filtres, un regroupement 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. : Events, Tasks, objets personnalisés, etc.) qui contient les enregistrements que vous souhaitez voir affichés dans votre calendrier.
* **Filtrage facultatif :** Si vous souhaitez afficher uniquement un sous-ensemble des 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 événements « Confirmed » ou les enregistrements d’une certaine plage de dates.
* **Regroupement (facultatif) :** Regroupez vos données pour organiser efficacement votre calendrier. Par exemple, un regroupement par champ de ressource (comme une salle, un propriétaire ou une équipe) sépare les événements en lignes de ressources distinctes.
* **Tri :** Sélectionnez un champ « Trier par » et une direction (croissante ou décroissante) pour déterminer l’ordre dans lequel les événements doivent apparaître.
* **Champs supplémentaires :** Si vous devez inclure dans votre calendrier des champs qui ne sont pas directement utilisés pour l’affichage ou les interactions, ajoutez-les dans la section « Champs supplémentaires ». Cela est particulièrement utile pour les champs que vous souhaitez rendre consultables dans la barre de recherche du calendrier.

### Mappage de données

Les mappages de données sont la clé pour garantir que les événements de vos enregistrements Salesforce s’affichent correctement dans votre Avonni Calendar. Voyez cela comme la traduction des informations de Salesforce dans un langage 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 ex. « Subject » sur l’objet standard Event).
* **Nom de la ressource :** Le champ indiquant à quelle ressource l’événement est affecté (par ex. un champ « Room » pour les réservations de salles ou un champ « Owner » pour les rendez-vous commerciaux). Si ce champ 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 ex. « StartDateTime »).
* **À :** Le champ Salesforce qui contient la date et l’heure de fin de l’événement (par ex. « EndDateTime »).

**Exemple :**

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

* **Titre :** Objet de la réunion
* **Nom de la ressource :** Nom de la salle
* **De :** Début prévu
* **À :** Fin prévue

### Paramètres généraux

**Nom d’API** est un identifiant unique utilisé pour référencer le composant. **Date de début** définit la date d’ouverture du calendrier. **Jour de début de la semaine** définit le jour de début de chaque semaine, et **Afficher le fuseau horaire** affiche le fuseau horaire du calendrier.

### **Affichage sélectionné**

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

<table><thead><tr><th width="178.33333333333331">Affichage sélectionné</th><th width="267">Description</th><th>Image</th></tr></thead><tbody><tr><td><strong>Calendrier</strong></td><td>Il s’agit de la vue traditionnelle en grille que la plupart des gens associent aux calendriers.</td><td><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-ede4a93ea9b7fb9a30cbd50715d67e0d1af34d36%2FCalendar%20Avonni%20Components.avif?alt=media" alt=""></td></tr><tr><td><strong>Agenda</strong></td><td>Chaque entrée de la liste comprend des détails sur l’événement et est classée par ordre chronologique.</td><td><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-3513329427e41c240f42f8f293d578acd4ada902%2FCalendar%20Avonni%20Components%20(1).avif?alt=media" alt=""></td></tr><tr><td><strong>Chronologie</strong></td><td>Offre aux utilisateurs une représentation visuelle linéaire de leur planning sur une période sélectionnable.</td><td><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-5711968b672b44e361c2d06395275f5e7a728ffc%2FCalendar.avif?alt=media" alt=""></td></tr></tbody></table>

### Variante de chronologie

Avonni Calendar propose deux façons d’afficher votre vue chronologique :

* **Chronologie horizontale :**
  * Les événements sont disposés horizontalement sur l’écran, la chronologie allant de gauche à droite.
  * Idéal pour visualiser des plannings sur une période plus longue (par ex. : semaines ou mois).
* **Chronologie verticale :**
  * Les événements sont empilés verticalement, la chronologie allant de haut en bas.
  * Cette vue fonctionne bien pour voir des plannings détaillés sur une journée ou quelques jours.

### Affichages masqués

**Affichages masqués** empêche les utilisateurs de sélectionner certaines vues lorsqu’ils interagissent avec l’Avonni Calendar. Choisissez n’importe quelle combinaison de **Agenda**, **Calendrier** et **Chronologie** — chacune de celles que vous sélectionnez disparaît du sélecteur d’affichage.

### Calendriers ICS

**Calendriers ICS** importe des événements depuis des fichiers ICS. Ajoutez une entrée par calendrier — soit un lien vers le fichier ICS, soit l’ID de document de contenu d’un fichier ICS stocké dans Salesforce — et ses événements sont affichés à côté de ceux provenant de la source de données.

Pour un lien, l’URL doit être enregistrée comme Remote Site Setting dans Salesforce, sinon l’appel sortant qui récupère le fichier est bloqué. Un lien qui renvoie autre chose qu’un fichier ICS est rejeté. Dans tous les cas, l’échec est silencieux pour le visiteur : cette entrée n’ajoute aucun événement, l’erreur n’atteint que la console du navigateur, et le reste du calendrier — les autres entrées ICS et les événements propres à la source de données — s’affiche toujours. Vérifiez la console si un lien ICS semble ne rien importer.

### Ajuster à l’écran

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

**Fonctionnement**

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

**Avantages**

* **Vue d’ensemble rapide :** Consultez tous vos événements planifiés en un coup d’œil.
* **Pas de défilement :** Évitez de faire défiler vers le haut et vers le bas pour trouver des événements.

**À garder à l’esprit**

* Avec de nombreux événements ou sur de très petits écrans, la vue compressée peut rendre les détails de chaque événement 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 ex. : « Planning de l’équipe commerciale », « Événements à venir », etc.).
* **Style de texte du titre de la barre d’outils :** Définissez la typographie de ce titre : famille de police, taille, épaisseur et couleur.
* **Masquer la barre d’outils :** Vous pouvez masquer toute la barre d’outils pour obtenir un aspect plus épuré ou maximiser l’espace d’affichage du calendrier.

### Avatar de la barre d’outils

La section Avatar de la barre d’outils vous permet d’ajouter une image à l’en-tête de votre Avonni Calendar. Cela peut aider à personnaliser le calendrier et à fournir un identifiant visuel.

### **Attributs de plage de temps**

d’Avonni Calendar **Attributs de plage de temps** offrent de la flexibilité pour consulter 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 ex. : afficher une semaine de travail de 4 jours).
* **Vue semaine :** Voir le planning complet d’une semaine d’un coup d’œil.
* **Vue mois :** Obtenez 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 de temps**

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

* **Libellé :** Donnez à votre plage de temps un nom descriptif (par ex. : « Semaine de travail »).
* **Nom de l’icône :** Sélectionnez une icône visuelle pour aider à identifier rapidement la plage de temps.
* **Unité :** Choisissez si cette plage de temps représente des jours, des semaines ou des mois.
* **Plage :** Définissez le nombre d’unités à afficher (par ex. : 5 jours, 2 semaines).

#### **En-têtes de chronologie (vue chronologique uniquement)**

Ajustez finement les en-têtes de votre vue chronologique pour afficher les informations les plus importantes pour vous, comme les numéros de semaine, les dates ou les mois.

### **Heures disponibles**

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

<table><thead><tr><th width="172">Attribut</th><th>Description</th></tr></thead><tbody><tr><td><strong>Jours</strong></td><td>Cette option vous permet de préciser quels jours de la semaine doivent être visibles dans le calendrier. Si elle est sélectionnée, le calendrier n’affichera que les jours choisis, masquant effectivement les autres.</td></tr><tr><td><strong>Mois</strong></td><td>Comme pour l’option Jours, vous pouvez choisir quels mois doivent être visibles dans votre calendrier.</td></tr><tr><td><strong>Plage horaire</strong></td><td>À l’aide de la plage horaire, vous pouvez contrôler précisément les heures visibles dans votre calendrier, en vous concentrant efficacement sur les créneaux les plus.</td></tr></tbody></table>

### **Affichage des événements**

La section Affichage des événements propose une gamme d’options pour personnaliser l’esthétique visuelle de vos événements de calendrier.

Voici les options disponibles :

* **Thème**: Cette option vous permet de choisir un thème visuel pour vos événements — **Par défaut**, **Vide**, **Ligne**, **Arrondi** ou **Transparent** — chacun offrant un style visuel unique pour s’adapter à vos préférences personnelles ou à l’identité de votre marque.
* **Palette**: Cette fonctionnalité vous permet d’attribuer différentes couleurs d’une palette choisie à chaque ressource. Une palette de couleurs est un ensemble de couleurs qui garantissent une utilisation cohérente des couleurs à travers différentes ressources. Cela aide à différencier visuellement et à identifier rapidement les différents types de ressources dans votre calendrier.
* **Palette personnalisée**: Créez plutôt votre propre palette, une couleur par entrée. Elle remplace **Palette**, et ses couleurs sont attribuées aux ressources de la même manière.
* **Champs de popover**: Lorsqu’un utilisateur survole un événement, ces champs seront affichés dans une petite fenêtre contextuelle (ou « popover »). Cela permet aux utilisateurs de consulter les détails essentiels de l’événement sans cliquer dessus. Chaque champ prend un **Libellé**, le champ d’événement qu’il lit dans **Valeur**, et un **Variante** qui place l’étiquette (**Standard**, **Libellé masqué**, **Libellé en ligne** ou **Libellé empilé**).
* **Masquer les événements de ressources vides**: masque les événements qui n’ont aucune ressource, ainsi que la **Vide** ligne de ressource sous laquelle ils seraient autrement regroupés et son entrée dans le filtre des ressources. Les événements importés via **Calendriers ICS** conservent leur **Vide** ligne. Désactivé par défaut.

### **Filtre**

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

* **Masquer le filtre des ressources :** Choisissez cette option pour supprimer le filtre qui permet aux utilisateurs d’afficher les événements en fonction de ressources spécifiques (par ex. : personnes, salles, équipements).
* **Masquer le sélecteur de date :** Sélectionnez cette option pour supprimer l’icône de calendrier dans l’en-tête qui permet aux utilisateurs d’accéder à une date spécifique.
* **Type :** Déterminez le style visuel et l’emplacement de la section de filtre :
  * **Horizontal :** Le paramètre par défaut — une barre en haut du calendrier.
  * **Popover :** Un filtre compact qui s’ouvre lorsqu’on clique dessus.
  * **Panneau gauche** / **Panneau droit :** Un panneau latéral pour les options de filtre, configuré sous **Attributs du panneau latéral**.
* **Utiliser les valeurs de liste de sélection des enregistrements :** Déduisez les options d’un filtre de liste de sélection à partir des valeurs réellement présentes dans les enregistrements, plutôt que de l’ensemble complet des valeurs du champ.
* **Utiliser les valeurs de filtre en cascade :** Réduisez les options des autres filtres pour qu’elles correspondent à la sélection actuelle lorsque les utilisateurs filtrent. Cela prime sur **Utiliser les valeurs de liste de sélection de l’enregistrement**.

Chaque filtre mappé sur la source de données possède également un opérateur, choisi dans un menu en haut du filtre. Les filtres de type texte, liste de sélection, liste de sélection à sélection multiple et recherche de relation offrent **Égal à** (par défaut), **Différent de**, **Vide** et **Non vide**. Les filtres de nombre, de date et d’heure offrent **Entre** (par défaut), **Pas entre**, **Égal à**, **Différent de**, **Inférieur à**, **Inférieur ou égal à**, **Supérieur à**, **Supérieur ou égal à**, **Vide** et **Non vide**. **Vide** et **Non vide** ne prennent aucune valeur, donc les entrées du filtre sont masquées lorsque l’un ou l’autre est sélectionné. Les filtres à case à cocher n’ont pas de menu d’opérateurs, pas plus que le filtre des ressources.

### **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.
* **Texte indicatif :** Ajoutez une courte phrase (par ex. : « Rechercher des événements... ») pour guider les utilisateurs sur ce qu’ils peuvent rechercher dans le calendrier.
* **Position :** Choisissez où placer la zone de recherche — **Gauche** (par défaut), **Droite**, **Centre**, **Remplissage**, ou **Panneau** pour la déplacer dans le panneau latéral à côté du calendrier.
* **Champs de recherche :** Mappés sur la source de données, ce sont les champs d’objet dans lesquels la zone de recherche effectue ses recherches. Ils nécessitent **Afficher la recherche**.

### **Panneau latéral**

**Attributs du panneau latéral** configurez le panneau que le calendrier peut afficher à côté de ses événements. Le panneau apparaît uniquement une fois que la recherche ou les filtres y sont placés — définissez **Position** à **Panneau** sous **Recherche**, ou **Type** à **Panneau gauche** ou **Panneau droit** sous **Filtre**.

* **Position :** de quel côté le panneau se trouve, **Gauche** (par défaut) ou **Droite**.
* **Fermé par défaut :** démarre le panneau replié. Désactivé par défaut.
* **Masquer le bouton bascule :** supprime le bouton d’en-tête avec lequel les utilisateurs ouvrent et ferment le panneau. Désactivé par défaut.
* **Libellé du bouton de réinitialisation :** le libellé du bouton qui efface toutes les sélections de filtres. `Effacer toutes les sélections` par défaut.

## Interactions

Le composant Avonni Calendar ne se contente pas d’afficher des événements ; il offre à vos utilisateurs plusieurs façons d’interagir directement avec lui et de déclencher d’autres actions.

### **Types d’actions**

* **Action Nouvel événement :** Personnalisez ce qui se passe lorsque les utilisateurs font glisser leur curseur sur le calendrier pour planifier un nouvel événement. Par exemple, vous pourriez ouvrir automatiquement un formulaire de création d’événement.
* **Actions de la barre d’outils :** Ajoutez des boutons personnalisés à la barre d’outils du calendrier. Ces boutons peuvent être programmés pour déclencher l’une des interactions disponibles 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 la modification, la suppression ou le déclenchement de processus supplémentaires liés à l’événement.

### **Interactions disponibles**

Le composant Avonni Calendar offre plusieurs interactions qui peuvent être déclenchées par les actions décrites ci-dessus :

* [**Afficher un toast**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/show-toast.md)**:** Affiche un bref message de notification à l’utilisateur, confirmant une action ou fournissant un retour.
* [**Naviguer**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/navigate.md)**:** Redirige l’utilisateur vers une autre page dans votre Experience Cloud ou vers un site web externe.
* [**Ouvrir une fenêtre modale d’alerte**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-alert-modal.md)**:** Présente une fenêtre contextuelle avec des informations importantes ou une demande de confirmation.
* [**Ouvrir la confirmation**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-confirm.md)**:** Affiche une boîte de dialogue de confirmation demandant à l’utilisateur de vérifier une action (par ex. : suppression d’un événement).
* [**Ouvrir la boîte de dialogue Flow**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-dialog.md)**:** Lance un Flow Salesforce, vous permettant d’automatiser des processus complexes ou de guider les utilisateurs à travers plusieurs étapes.
* [**Ouvrir le panneau Flow**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-panel.md)**:** Lance un Flow Salesforce dans un panneau latéral à côté du calendrier plutôt que dans une boîte de dialogue.
* [**Exécuter le Flow**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/execute-flow.md)**:** Exécute un Flow Salesforce lancé automatiquement en arrière-plan, sans boîte de dialogue ni panneau.
* [**Télécharger**](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/download.md)**:** Télécharge un fichier, soit depuis une URL, soit depuis un document de contenu 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, Barre d’outils, Menu contextuel) disposera d’une section dans laquelle vous pourrez définir l’interaction à déclencher.

## Style

{% tabs %}
{% tab title="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éborde du calendrier.
  * **Masqué :** Le contenu est rogné aux bords du calendrier.
  * **Défilement :** Le calendrier affiche des barres de défilement si le contenu déborde.
    {% endtab %}

{% tab title="Barre d’outils" %}

* **Couleur d’arrière-plan :** 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 la vue, etc.).
  {% endtab %}

{% tab title="Panneau des filtres" %}
Met en forme le panneau latéral qui contient les filtres et la recherche.

* **Panneau des filtres :** Couleur d’arrière-plan / couleur de bordure / taille de bordure / style de bordure / rayon de bordure.
* **Libellés du panneau des filtres :** Arrière-plan / arrière-plan actif / arrière-plan au survol ; couleur de l’icône de réduction ; couleur / couleur active / couleur au survol ; taille de police / graisse de police.
* **Options du panneau des filtres :** Couleur ; couleur de bordure de la case à cocher ; couleur du texte du bouton Charger plus / couleur du texte actif / couleur du texte au survol.
* **Bouton de réinitialisation du panneau des filtres :** Couleur d’arrière-plan / Couleur du texte / Couleur de bordure / Taille de bordure / Rayon de bordure.
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/experience-components/ax-calendar.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.