# Feuille de Sondage

La feuille Survey est le cœur de votre XLSForm. C’est là que vous définissez les questions qui seront posées dans votre formulaire, leurs types, étiquettes, noms et la logique telle que les skips, la pertinence (relevance) et les contraintes.

Chaque ligne de la feuille survey représente une question, une note ou un groupe. Chaque colonne fournit des informations sur le comportement de cette question.

Voici un exemple simple de ce à quoi cela peut ressembler :

<table><thead><tr><th>type</th><th width="128">nom</th><th>label</th><th>appearance</th><th>required</th><th>relevant</th><th>constraint</th><th>hint</th></tr></thead><tbody><tr><td>begin_group</td><td>page1</td><td>Page d'informations personnelles</td><td>field-list</td><td></td><td></td><td></td><td></td></tr><tr><td>note</td><td>startnote</td><td>Nous réalisons un nouveau Sondage, veuillez remplir les questions suivantes.</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>text</td><td>nom</td><td>Quel est votre nom complet ?</td><td></td><td>yes</td><td></td><td></td><td>Saisissez votre prénom et votre nom.</td></tr><tr><td>integer</td><td>age</td><td>Quel âge avez-vous ?</td><td></td><td>yes</td><td></td><td>. >= 0 and . &#x3C;= 120</td><td>Doit être compris entre 0 et 120.</td></tr><tr><td>select_one sex</td><td>gender</td><td>Quel est votre genre ?</td><td></td><td></td><td>${age} >= 10</td><td></td><td>Sélectionnez une option.</td></tr><tr><td>end_group</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## 🔑 Colonnes clés expliquées

1. **Type**\
   Ceci définit le type de question que vous posez. Types courants :

* `text` – pour la saisie de texte
* `integer` ou `decimal` – pour les nombres
* `select_one list_name` – pour les questions à choix unique
* `select_multiple list_name` – pour les questions à choix multiple
* `note` – pour afficher du texte statique
* `begin group` / `end group` – pour organiser les questions en [groupes](/fr/projects/import-export/xlsform/feuille-de-sondage/groupes.md) de pages ou groupes de réponses

{% hint style="info" %}
`select_one gender` signifie que les choix proviennent d’une liste nommée `gender` (qui sera définie dans la feuille Name).
{% endhint %}

#### 2. Name

Ceci est le nom de variable utilisé en interne. Il doit être :

* court et descriptif
* en minuscules, sans espaces ni caractères spéciaux
* unique au sein du formulaire

{% hint style="info" %}
Le nom de variable est la façon dont les données seront référencées lors de l’utilisation des fonctionnalités relevant et constraint
{% endhint %}

#### 3. Label

Ceci est le texte de la question que l’utilisateur voit. Il prend également en charge [plusieurs langues](/fr/projects/import-export/xlsform/feuille-de-sondage/multilingue.md) si vous devez créer un Sondage en plusieurs langues (par ex., `label::English`, `label::French`).

{% hint style="info" %}
Soyez clair et facile à comprendre. Par exemple : « Quel est votre intitulé de poste actuel ? »
{% endhint %}

#### 4. Appearance (optionnel)

L’apparence vous permet de contrôler des propriétés supplémentaires pour chacun de vos éléments. ngSurvey prend en charge plusieurs [options d’apparence](/fr/projects/import-export/xlsform/feuille-de-sondage/apparences.md) pour générer des échelles de notation, des pages, des zones de commentaire, des saisies masquées ou des alignements personnalisés des champs. &#x20;

#### 4. Required (optionnel)

Définir sur `yes` si la question ou la Réponse doit être fournie avant de continuer. Si laissé vide, la question est optionnelle&#x20;

#### 5. Relevant (optionnel)&#x20;

Utilisé pour le Skip Logic. La question n’apparaît que si la condition est satisfaite.

> &#x20;Exemple : `relevant: ${age} >= 18`\
> La question n’apparaîtra que si l’âge est de 18 ans ou plus.

#### 6. Constraint (optionnel)

Utilisé pour valider les réponses en utilisant une logique si la réponse est basée sur une saisie de texte.

> &#x20;Exemple : `. >= 0 and . <= 100`\
> Cela garantit que la saisie est comprise entre 0 et 100. Le `.` représente la réponse de la question courante.

#### 7. Hint (optionnel)

Texte d’aide affiché sous forme d’infobulle « ? » pour expliquer à l’utilisateur ce qui est attendu lorsqu’on passe le curseur dessus.


---

# 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://docs.ngsurvey.com/fr/projects/import-export/xlsform/feuille-de-sondage.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.
