# Formulaires de libre-service
## Vue d’ensemble
Vous pouvez utiliser les formulaires en libre-service pour collecter des données structurées auprès des utilisateurs. Cela peut servir à permettre aux utilisateurs de signaler des incidents ou d’indiquer des changements, comme la الحاجة d’une nouvelle configuration de poste de travail dans un bureau.
« Self Service Forms » est une fonctionnalité optionnelle qui peut être activée pour votre tenant par le support RealmJoin. Si elle n’est pas activée, vous pouvez toujours saisir/préparer des formulaires dans la page des paramètres, mais les utilisateurs ne pourront pas voir/utiliser les formulaires en libre-service.
Nous utiliserons un workflow pour « indiquer un nouvel animal de compagnie » comme exemple.
Exemple de formulaire
## Utilisation des formulaires
En utilisant le  élément de navigation, les utilisateurs peuvent sélectionner un formulaire à remplir et à envoyer.
Sélecteur de formulaire
Lorsqu’un utilisateur remplit et envoie un formulaire, son contenu sera envoyé par e-mail au destinataire indiqué dans la définition du formulaire. L’e-mail sera envoyé via l’infrastructure de RealmJoin et n’émanera pas des adresses e-mail de votre entreprise.
Exemple d’e-mail d’un formulaire
{% hint style="info" %}
Lorsque les formulaires en libre-service sont activés pour votre tenant, tous les utilisateurs peuvent utiliser / envoyer des formulaires.
{% endhint %}
## Examiner les soumissions
En utilisant le  icône de navigation, vous pouvez examiner les anciennes soumissions de formulaires de vos utilisateurs.
Liste des soumissions
Vous pouvez rechercher des soumissions par nom d’utilisateur et par nom de formulaire, mais pas par champs dans la soumission du formulaire.
Cliquez sur « View » pour voir les données du formulaire rempli. La vue est en lecture seule.
## Page des paramètres
La page des paramètres des formulaires en libre-service permet de gérer les formulaires existants, d’ajouter, de modifier et de supprimer des formulaires.
### Liste des formulaires sur la page des paramètres
Liste des formulaires
Utilisez « New Form » ou « Edit » pour décrire le formulaire à l’aide de [JSON Schema](https://json-schema.org/). Cela définit quels champs doivent être saisis et quelles valeurs sont valides. L’interface propose un éditeur de vérification de syntaxe et un aperçu du formulaire résultant.
Le schéma sera utilisé pour créer dynamiquement un formulaire pour l’utilisateur. En pratique, utilisez le schéma non seulement pour décrire les données souhaitées, mais aussi pour créer implicitement l’interface utilisateur du formulaire.
### Éditeur de schéma
Au-dessus de l’éditeur se trouvent deux champs. Utilisez le champ de gauche pour donner à votre formulaire un nom descriptif. Utilisez le champ de droite pour nommer l’adresse e-mail du destinataire des données soumises par l’utilisateur.
Exemple d’éditeur de schéma
Vous pouvez utiliser « Update JSON Form Preview » pour créer un aperçu du formulaire résultant sous l’éditeur.
Aperçu de l’éditeur
Après avoir modifié le schéma, appuyez sur « Submit » pour enregistrer vos modifications. Un message d’erreur s’affichera si la vérification de syntaxe échoue.
## JSON Schema
L’utilisation de JSON Schema sort du cadre de ce document. Vous pouvez utiliser des générateurs de schémas en ligne (comme [celui-ci](https://www.jsonschema.net/app)) pour simplifier le processus.
Pour donner au moins un point de départ, examinons le schéma de notre exemple
```json
{
"title": "Personne",
"type": "object",
"required": [
"name",
"date",
"location",
"pets"
],
"properties": {
"name": {
"type": "string",
"description": "Prénom et nom",
"minLength": 4,
"default": "- Votre nom ici -"
},
"date": {
"type": "string",
"format": "date",
"options": {
"flatpickr": {}
}
},
"location": {
"type": "object",
"title": "Emplacement",
"properties": {
"city": {
"type": "string",
"default": "San Francisco"
},
"state": {
"type": "string",
"default": "CA"
},
"citystate": {
"type": "string",
"description": "Ceci est généré automatiquement à partir des deux champs précédents",
"template": "{{city}}, {{state}}",
"watch": {
"city": "location.city",
"state": "location.state"
}
}
}
},
"pets": {
"type": "array",
"format": "table",
"title": "Animaux de compagnie",
"uniqueItems": true,
"items": {
"type": "object",
"title": "Animal de compagnie",
"properties": {
"type": {
"type": "string",
"enum": [
"chat",
"chien",
"oiseau",
"reptile",
"autre"
],
"default": "chien"
},
"name": {
"type": "string"
}
}
},
"default": [
{
"type": "chien",
"name": "Walter"
}
]
}
}
}
```
Chaque JSON Schema se compose d’objets. Chaque objet doit au minimum avoir un type et un nom.
### Types
#### Objet
Les objets « complexes » contenant d’autres sous-objets doivent utiliser le **type** object. Dans notre exemple, le nœud racine « Person » du schéma est de ce type.
Vous pouvez définir des champs obligatoires à l’aide du mot-clé **required** . Ces champs doivent également être définis dans le schéma.
Utilisez **properties** pour décrire les caractéristiques requises de chaque champ, ce qui inclut la fourniture d’un type et d’un nom.
#### Tableau
Les tableaux vous permettent d’ajouter plusieurs **éléments** similaires à une liste. Utilisez le **éléments** mot-clé pour décrire le type des éléments, etc.
#### String
Du texte simple. Vous pouvez le préremplir à l’aide du **par défaut** mot-clé.
Pour n’autoriser que certaines valeurs, vous pouvez utiliser le **enum** mot-clé.
