> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/laffichage-des-donnees/plannings.md).

# Calendrier

Le **Calendrier** permet de visualiser les enregistrements comportant au moins un champ de type « Date » dans une vue dédiée.

## ➕ Créer un Calendrier

Depuis l'onglet *Données* de la barre d'ajout d'un élément, cliquez sur **Ajouter un affichage** puis sur **Calendrier**. Vous pouvez ensuite cliquer sur le calendrier placé dans votre page afin d’en modifier les paramètres.

<figure><img src="/files/Ka7NekKc0ygGTpEF6wUI" alt=""><figcaption></figcaption></figure>

## ⚙️ Paramétrer votre Calendrier

{% hint style="info" %}
Pensez à renommez votre Calendrier afin de le retrouver plus facilement dans l'application.&#x20;
{% endhint %}

### 🗂️ Paramétrage des sources

> Une **source est créée par défaut**. Vous pouvez en ajouter d’autres en cliquant sur **« Ajouter une source »** en bas de la configuration.

👉 Vous pouvez renommer votre source en cliquant sur le crayon à côté de son nom :&#x20;

<figure><img src="/files/QqiAVaQUT8tlkPwG0TUY" alt="" width="299"><figcaption></figcaption></figure>

1️⃣ Sélectionnez la table source à partir de laquelle les enregistrements seront récupérés pour être affichés dans le Calendrier.

2️⃣ Choisissez les enregistrements à afficher.

<details>

<summary>Options de récupération des enregistrements : </summary>

👉🏼  **De l'Utilisateur connecté** : signifie que les enregistrements qui s'afficheront dans le Calendrier seront issues des enregistrements remplis par l'Utilisateur connecté uniquement. \
Par exemple, si l'Utilisateur a rempli 1 workflow "Ajouter une activité", alors, lors d'un ajout d'activité, seulement 2 activités apparaîtront sur le calendrier.\
\
👉🏼 **Des Groupes auxquels appartient l'Utilisateur** : signifie que les enregistrements qui s'afficheront dans le Calendrier seront issues des enregistrements remplis par l'Utilisateur ET des enregistrements remplis par les Utilisateurs faisant partie du même Groupe.\
Par exemple : si Marie et Paul font partie du même Groupe et qu'ils ont renseignés 2 activités chacun, alors 4 activités s'afficheront dans le Calendrier. \
\
👉🏼 **de Tout le monde** : signifie que les enregistrements qui s'afficheront dans le Calendrier seront issues des enregistrements remplis par tous les Utilisateurs de l'Application.&#x20;

</details>

3️⃣ Sélectionnez le champ de la table source correspondant à la date (ou date et heure) qui doit être utilisée pour l’affichage dans le Calendrier.

4️⃣ Modifiez la couleur d’affichage des enregistrements dans le Calendrier. La couleur peut être définie :

* à partir d’une **valeur personnalisée**, via un sélecteur de couleur ;
* ou à partir de la **valeur d’un champ**, en utilisant un champ de type couleur.

<figure><img src="/files/oTvHA8PMCYYWdBITxv7J" alt="" width="296"><figcaption><p>Option disponible dans les paramètres d'une source</p></figcaption></figure>

<figure><img src="/files/oZmvDGPfK3nCkGvtzMms" alt="" width="485"><figcaption><p>Exemple de paramétrage de la couleur d'un calendrier - couleur en fonction du statut</p></figcaption></figure>

5️⃣ Définissez le titre des événements qui s’affichera dans le Calendrier. Il est possible d'utiliser des variables pour personnaliser le titre en fonction des enregistrements.

6️⃣  *(facultatif)* Choisissez une **redirection** vers :

* un Workflow
* une Fiche
* un Suivi
* ou un lien externe

7️⃣ *(facultatif)* Ajoutez des [**filtres**](/ksaar-documentation/aller-plus-loin/les-conditions.md) afin de conditionner l’affichage des enregistrements dans le Calendrier.\
*Exemple : afficher uniquement les activités de type « Réunion ».*\
Vous pouvez définir des conditions d'affichage des enregistrements en fonction :&#x20;

* de la valeur d'**un champ Utilisateur** (identifiés par le (U) devant leur identifiant unique)
* de la valeur d'un **champ de la table.**
* d'un Persona, d'un Utilisateur, d'une table, d'une étape de suivi en cours, de la date de création, de la date de modification, du statut de l'enregistrement.

<figure><img src="/files/c9pmuz45ygWxYfrYZO8q" alt="" width="268"><figcaption><p>Exemple de paramétrage d'une source</p></figcaption></figure>

### 🔽 Paramètres spécifiques à l'emplacement

Dans les **paramètres spécifiques à l’emplacement**, après avoir **placé votre Calendrier**, choisissez :

* Les vues disponibles pour les utilisateurs de votre application : jour, semaine, mois et/ou année
* La vue par défaut, parmi les vues disponibles
* Les jours masqués. Pour masquer certains jours : ceux sélectionnés ne sont pas affichés et sont ignorés dans la navigation. Il est impossible de sélectionner tous les jours simultanément.
* La date affichée par défaut :
  * la date du jour
  * ou une date issue d’un champ Date ou Date et heure
* La plage horaire affichée dans le calendrier, afin de limiter l'affichage à certaines heures de la journée :
  * l'heure de début
  * l'heure de fin
* L’activation ou non d’une hauteur fixe pour le Calendrier
* L’option Afficher uniquement les enregistrements créés par l’Utilisateur connecté

<figure><img src="/files/oaDvHTnWec1xfKH4JwMJ" alt="" width="314"><figcaption><p>Configuration du calendrier</p></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/laffichage-des-donnees/plannings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
