> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/user-documentation/documentation-utilisateur/build/building-forms/fields/simple-fields.md).

# Champs simples

Types de champs standards pour saisir du texte, des nombres, des dates, des photos et plus encore.

## Présentation

*Cette catégorie permet d'afficher la même information sur toutes les fiches.*

### Titre

Le titre est saisi dans le libellé du champ, dans les options générales. Cette information est visible par l'utilisateur aussi bien sur mobile que sur le web.

### Texte statique

* **Texte enrichi :** mode avancé proposant quelques options de mise en forme basées sur le langage [Markdown](https://fr.wikipedia.org/wiki/Markdown)
* **Éditer le texte :** permet de saisir le texte qui sera affiché aux utilisateurs (obligatoire)

### Logo

* **Logo en bandeau :** permet d'afficher l'image sur toute la largeur de l'écran
* **Téléverser :** choix de l'image qui sera affichée dans le formulaire (obligatoire)
* **Masqué sur le formulaire web :** permet de s'assurer que l'image n'est affichée que sur mobile

## Données

*Cette catégorie permet à l'utilisateur de saisir une information, dont le type a été choisi.*

{% hint style="info" %}
**La mise en forme des valeurs ne peut pas être personnalisée.** Pour des champs comme Nombre et Date, la façon dont les valeurs sont affichées (séparateur décimal, séparateur de milliers, ordre jour/mois/année, etc.) est automatiquement appliquée selon la [langue](/user-documentation/documentation-utilisateur/build/managing-users/users.md) de chaque utilisateur, et non configurée par champ ou par formulaire.
{% endhint %}

### Texte

* **Texte enrichi :** mode avancé proposant quelques options de mise en forme basées sur le langage [Markdown](https://fr.wikipedia.org/wiki/Markdown).
* **Valeur par défaut :** applique la valeur saisie dans le champ.
* **Liste liée :** permet de proposer une autocomplétion lorsque l'utilisateur saisit le premier caractère d'un élément de la [liste](/user-documentation/documentation-utilisateur/build/building-forms/lists-management.md) choisie.
* **Scan de code-barres :** permet aux utilisateurs mobiles d'utiliser la caméra pour scanner un code qui sera renseigné dans le champ texte.
* **Scan externe :** permet au mobile de copier les données d'un scanner Bluetooth.
* Les textes sont limités à 5 000 caractères.

{% hint style="info" %}
**Saisie vocale :** les utilisateurs peuvent également renseigner ce champ à la voix, grâce à la fonction native de dictée (speech-to-text) intégrée au clavier Android ou iOS. Il s'agit d'une fonctionnalité de l'appareil, pas d'un paramètre Daxium-Air.
{% endhint %}

### Nombre

* **Format :** conversion de la donnée dans un format numérique.
* **Valeur minimale :** définit une limite inférieure sur les valeurs acceptées.
* **Valeur maximale :** définit une limite supérieure sur les valeurs acceptées.
* **Valeur par défaut :** applique la valeur saisie dans le champ.
* Nous suivons la norme [IEEE 754](https://ieeexplore.ieee.org/xpl/mostRecentIssue.jsp?punumber=4610933). La précision de la valeur dépend de son format. Pour un entier, la valeur doit être comprise entre -9223372036854775808 et 9223372036854775807, soit entre -2^63 et (2^63)-1. Pour un nombre décimal, la valeur est tronquée aux 14 premiers chiffres significatifs.

### Booléen (Vrai/Faux)

**Valeur par défaut :** applique la valeur saisie dans le champ.

### Date

**Format :** permet de définir si vous n'utilisez que la date ou si vous ajoutez également l'heure.

* **Date minimale / Date maximale :** restreint les dates sélectionnables à partir de / jusqu'à un autre champ ou une formule de type date du formulaire. Le sélecteur de date bloque toute date en dehors de cette plage, sur web, sur mobile et hors connexion. Il n'est pas possible de saisir une date fixe : la borne doit obligatoirement référencer un champ.

Les champs date sont enregistrés au format [Unix Timestamp](https://fr.wikipedia.org/wiki/Heure_Unix).

{% hint style="info" %}
**Empêcher la sélection d'une date passée ou future.** Comme Date minimale/Date maximale ne peuvent référencer qu'un champ, il faut créer un champ représentant « aujourd'hui » : ajoutez un champ [formule](/user-documentation/documentation-utilisateur/build/building-forms/fields/formulas.md) de type Date qui retourne la date du jour, par exemple :

```javascript
return new Date().getTime() / 1000;
```

Réglez sa [règle de calcul](/user-documentation/documentation-utilisateur/build/building-forms/fields/formulas.md#regles-de-calcul) sur **Rafraîchissement automatique** pour qu'il reflète toujours la date actuelle, puis masquez-le aux utilisateurs via ses [permissions de champ](/user-documentation/documentation-utilisateur/build/building-forms/conditions.md#permissions-de-champ). Sélectionnez ce champ formule comme **Date minimale** pour bloquer les dates passées, ou comme **Date maximale** pour bloquer les dates futures.
{% endhint %}

### Durée

**Format :** min:sec:micro ou min:sec

### Localisation

Ce champ permet de collecter une adresse et des coordonnées GPS (format WGS 84) via Google Maps. Vous pouvez le renseigner de trois manières :

* **Choisir une localisation depuis Google Maps** — sélectionnez un point directement sur la carte.
* **Saisir une adresse** — lors de l'enregistrement de la fiche, Daxium-Air détermine les coordonnées GPS de l'adresse via l'API Google Maps.
* **Saisir les coordonnées GPS** — au moment où vous cliquez sur enregistrer, Daxium-Air renvoie l'adresse correspondante à côté de celles-ci via Google Maps.

### E-mail

**Valeur par défaut :** applique la valeur saisie dans le champ.

Les champs e-mail doivent être conformes à la [RFC3696](https://tools.ietf.org/html/rfc3696) et à la [RFC2821](https://www.ietf.org/rfc/rfc2821.txt).

### Téléphone

**Valeur par défaut :** choisissez le format du numéro en fonction du pays (en agissant sur le drapeau) et appliquez la valeur saisie dans le champ.

### Image

* **Format :** choix de la résolution pour redimensionner l'image.
  * **Basse :** 640×480
  * **Normale :** 1024×768
  * **Haute :** 2048×1536
  * **Originale :** résolution d'origine (définie dans les paramètres du mobile) — limitée à 80 Mo

Ce menu déroulant permet de choisir la résolution de redimensionnement d'une image prise par un appareil mobile. Il est fortement recommandé de réduire la résolution par défaut des photos de smartphone, celle-ci étant très élevée et allongeant donc le temps de transfert des fichiers (taille du fichier).

* **Limite d'images :** fixe le nombre maximum d'images pouvant être rattachées au champ.
* **Nom du fichier :** permet d'attribuer un nom au fichier.
* **Valeur par défaut :** préremplit le champ avec une image dans chaque nouvelle fiche, par exemple le schéma d'un véhicule ou un plan que l'utilisateur terrain annote ensuite. Déposez l'image dans la zone, ou cliquez sur la zone pour la sélectionner. Une image par champ, au format JPEG, PNG, GIF ou TIFF, jusqu'à 20 Mo. L'utilisateur terrain peut la remplacer ou la supprimer dans une fiche. L'image ne s'applique qu'aux fiches créées après l'activation du formulaire ; la retirer ensuite ne modifie pas les fiches qui la contiennent déjà.

### Fichier

**Nom du fichier :** permet d'attribuer un nom au fichier

* Voici la liste des **formats autorisés :** image/gif, image/jpeg, image/png, image/tiff, image/x-png
* text/csv, text/plain, text/xml
* video/mpeg, video/mp4, video/x-msvideo
* application/zip, application/pdf, application/x-rar-compressed, application/x-tar, application/x-7z-compressed, application/x-zip-compressed
* La taille du fichier ne doit pas dépasser 80 Mo

### Signature

**Nom du fichier :** permet d'attribuer un nom au fichier.

Le fichier de signature est limité à 80 Mo.

### Liste

* **Liste liée :** associe le champ à une [liste](/user-documentation/documentation-utilisateur/build/building-forms/lists-management.md).
* **Multiple :** permet de sélectionner plusieurs valeurs dans la liste. *L'ordre des valeurs sélectionnées ne peut pas être configuré : elles s'affichent dans leur ordre d'apparition dans la liste, et non dans l'ordre de sélection.*
* **Affichage :** permet de choisir les composants affichés.
* **Type d'affichage sur mobile :** permet d'utiliser un autre mode d'affichage d'une liste sur le formulaire mobile.
* **Source d'entrée (mobile uniquement) :** permet de renseigner le champ liste en scannant un code-barres. Le scan par caméra fonctionne sur les deux plateformes, mais avec des règles différentes : iOS ne permet de scanner qu'un seul élément, et uniquement lorsque le champ est vide ; Android permet le scan en rafale sur les listes à choix multiple, chaque élément scanné s'ajoutant aux valeurs déjà sélectionnées. Le code est comparé au nom ou à l'identifiant externe des éléments de la liste rattachée, en correspondance exacte et insensible à la casse.
* **Dépendance à une liste :** cette fonction permet de lier plusieurs champs de type liste entre eux, afin de suivre une arborescence. *Disponible uniquement sur une liste à choix unique, donc pas en multiple.*
* **Saisie partielle :** permet d'arrêter la saisie d'une liste à un certain niveau de son arborescence.
* **Continuer la saisie :** permet de poursuivre la saisie partielle d'un champ liste précédent du formulaire.
* **Terminer la saisie :** permet de compléter la saisie d'un champ liste précédent (en allant jusqu'au bout de l'arborescence).

Les listes sont limitées à 100 000 éléments. Pas de limite sur le nombre d'éléments sélectionnés.

### Utilisateur

* **Multiple :** permet de sélectionner plusieurs utilisateurs dans le champ.
* **Affichage :** permet de choisir si les utilisateurs sont affichés par leur nom complet ou par leur e-mail.
* **Limiter à un groupe :** restreint les utilisateurs sélectionnables aux membres d'un groupe d'utilisateurs choisi.

Un champ Utilisateur expose toujours l'e-mail, le prénom et le nom de chaque utilisateur sélectionné aux formules, indépendamment de l'option d'affichage. Voir [Formules](/user-documentation/documentation-utilisateur/build/building-forms/fields/formulas.md) pour le format de la valeur. Assigner un utilisateur inactif à ce champ est rejeté, sauf si cet utilisateur était déjà sélectionné avant l'enregistrement. Voir [Règles d'enregistrement des fiches](/user-documentation/documentation-utilisateur/support/admin-support/submission-saving-rules.md#validation-des-champs) pour le détail.

{% hint style="info" %}
**`separator` n'est pas un type de champ.** C'est le nom d'un paramètre utilisé par les fonctions de rapport `List()` et `Split()` pour définir le caractère qui assemble ou découpe les valeurs. Voir [Syntaxe des rapports](/user-documentation/documentation-utilisateur/build/building-the-reporting/syntax-functions.md#fonctions-utilitaires).
{% endhint %}


---

# 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://www.center.daxium-air.com/user-documentation/documentation-utilisateur/build/building-forms/fields/simple-fields.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.
