# Les variables disponibles

Les **variables** sont des balises que tu insères dans tes modèles de documents. Au moment de la génération, TousQuali les remplace automatiquement par les vraies informations.

**Format** : toutes les variables s'écrivent entre crochets : `[nom_de_la_variable]`

***

## Variables disponibles

Les variables utilisables dans les modèles de documents sont les mêmes que celles disponibles dans les modèles d'emails : participant·e, session, OF, formateur·rice, client·e.

→ **Consulte la liste complète dans la section** [**Gestion des modèles d'emails**](/emails/03-templates-emails.md#variables-disponibles)

***

## Variables spécifiques aux documents

En plus des variables communes, les modèles de documents disposent de variables supplémentaires liées au document lui-même :

| Variable                  | Contenu                         |
| ------------------------- | ------------------------------- |
| `[document_name]`         | Nom du document                 |
| `[document_published_at]` | Date de publication du document |
| `[document_version]`      | Numéro de version               |

## Codes courts (liens)

Les codes courts génèrent des **liens cliquables** vers les espaces personnels. Ils sont disponibles dans les modèles de documents et d'emails.

| Code court               | Contenu                                             |
| ------------------------ | --------------------------------------------------- |
| `[entry_link]`           | Lien vers l'espace personnel du·de la participant·e |
| `[session_teacher_link]` | Lien vers l'espace formateur·rice de la session     |

***

## Exemple d'utilisation

```
CONTRAT DE FORMATION PROFESSIONNELLE

Entre :
[company_name], enregistré sous le numéro [company_nda_number],
SIRET : [company_company_id_number],
représenté par [company_administrator],

Et :
[entry_name], demeurant [entry_address],

Article 1 – Objet
Formation : [session_training]
Du [session_started_at] au [session_ended_at]
Durée : [session_nb_hours] heures ([session_nb_days] jours)
Lieu : [session_place_name]

Article 2 – Prix
Montant : [entry_price_ht] € HT
```

***

## Conseils

* **Variable vide** : si une variable ne trouve pas de valeur (ex : téléphone non renseigné), elle s'affiche vide dans le document. Vérifie que les fiches participant·e et session sont bien complètes avant de générer.
* **Tester** : utilise le bouton "Prévisualiser" pour vérifier que tes variables sont bien remplacées avant de publier le modèle.
* **Pastilles visuelles** : dans l'éditeur, les variables s'affichent sous forme de badges colorés pour les distinguer du texte normal. Elles ne peuvent pas être modifiées accidentellement — tu peux uniquement les supprimer et en insérer une nouvelle.


---

# Agent Instructions: 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:

```
GET https://documentation.tousquali.fr/documents/06-variables-shortcodes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.