> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/fr/administration-et-parametres/self-service-forms.md).

# Formulaires en libre-service

Les formulaires en libre-service RealmJoin recueillent des données structurées auprès des utilisateurs, comme les rapports d’incident ou les demandes de changement, une fois activés par le support.

## Aperçu

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 le besoin d'une nouvelle configuration de poste de travail dans un bureau.

« Formulaires en libre-service » est une fonctionnalité facultative qui peut être activée pour votre tenant par le support RealmJoin. Si elle n'est pas activée, vous pouvez tout de même saisir/préparer des formulaires sur la page des paramètres, mais les utilisateurs ne pourront pas voir/utiliser les formulaires en libre-service.

Nous utiliserons un flux de travail pour « indiquer un nouvel animal de compagnie » comme exemple.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fk4raaucFdNBWERFd1K7V%2Fimage.png?alt=media&amp;token=1e3f9fb5-66eb-405e-962f-ba1adab495b6" alt=""><figcaption><p>Exemple de formulaire</p></figcaption></figure>

## Utilisation des formulaires

À l'aide du ![](https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FEoSZwvVn9NMFPA1LgGVn%2Fimage.png?alt=media\&token=0ef42605-f332-45bc-8a1d-503b842f8c12) élément de navigation, les utilisateurs peuvent sélectionner un formulaire à remplir et à envoyer.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FPUnJnLhYCdcgI9aTfJew%2Fimage.png?alt=media&amp;token=6455eb83-923f-4a39-b871-43d73f2d43c5" alt=""><figcaption><p>Sélecteur de formulaire</p></figcaption></figure>

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 ne proviendra pas des adresses e-mail de votre entreprise.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FOk30wlZKDMEe3MWvzxS1%2Fimage.png?alt=media&amp;token=c40cb2ea-113c-4b4f-9da0-ff085a808b65" alt=""><figcaption><p>Exemple d'e-mail provenant d'un formulaire</p></figcaption></figure>

{% hint style="info" %}
Lorsque les formulaires en libre-service sont activés pour votre tenant, tous les utilisateurs peuvent utiliser / soumettre des formulaires.
{% endhint %}

## Examiner les soumissions

À l'aide du ![](https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FzLUitkjFFMieHZaQppjS%2Fimage.png?alt=media\&token=bb07172e-904c-459d-a9a8-e73c48f18ae6) icône de navigation, vous pouvez consulter les anciennes soumissions de formulaires de vos utilisateurs.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FhW7xAk19PilNZOMOGodf%2Fimage.png?alt=media&amp;token=adc9d2ba-359a-4fa1-b272-996d354c6b4f" alt=""><figcaption><p>Liste des soumissions</p></figcaption></figure>

Vous pouvez rechercher les soumissions par nom d'utilisateur de l'expéditeur et par nom du formulaire, mais pas par les champs dans la soumission du formulaire.

Cliquez sur « Voir » 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'en ajouter, de les modifier et de les supprimer.

### Liste des formulaires sur la page des paramètres

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FYfij5VCCe1WNBYeIe1Jl%2Fimage.png?alt=media&amp;token=e6f11b7c-8a3e-42ba-aeaf-57f6b5fa8b08" alt=""><figcaption><p>Liste des formulaires</p></figcaption></figure>

Utilisez « Nouveau formulaire » ou « Modifier » pour décrire le formulaire à l'aide de [schéma JSON](https://json-schema.org/). Cela définit quels champs doivent être saisis et quelles valeurs sont valides. L'interface utilisateur 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, il y a deux champs. Utilisez le champ de gauche pour donner à votre formulaire un nom descriptif. Utilisez le champ de droite pour indiquer l'adresse e-mail du destinataire des données soumises par l'utilisateur.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FlDKKa8gI37FWDapkH2xh%2Fimage.png?alt=media&amp;token=d13dbe12-150a-4503-ba1c-50d637962498" alt=""><figcaption><p>Exemple d'éditeur de schéma</p></figcaption></figure>

Vous pouvez utiliser « Mettre à jour l'aperçu du formulaire JSON » pour créer un aperçu du formulaire résultant sous l'éditeur.

<figure><img src="https://1100180853-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FPqMhyTDusXhcaIcafvFu%2Fimage.png?alt=media&amp;token=f04e8882-1d3c-4bd4-a032-2af26f763e59" alt=""><figcaption><p>Aperçu de l'éditeur</p></figcaption></figure>

Après avoir modifié le schéma, appuyez sur « Envoyer » pour enregistrer vos modifications. Une erreur s'affichera si la vérification de syntaxe échoue.

## schéma JSON

L'utilisation du schéma JSON dépasse le 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 de famille",
      "minLength": 4,
      "default": "- Votre nom ici -"
    },
    "date": {
      "type": "string",
      "format": "date",
      "options": {
        "flatpickr": {}
      }
    },
    "location": {
      "type": "object",
      "title": "Localisation",
      "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 schéma JSON 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 devraient utiliser le **object** type. Dans notre exemple, le nœud racine "Personne" du schéma est de ce type.

Vous pouvez définir des champs obligatoires à l'aide du **required** mot-clé. Ces champs doivent également être définis dans le schéma.

Utilisez **properties** pour décrire les caractéristiques de chaque champ nécessaire, y compris lui donner un type et un nom.

#### Tableau

Les tableaux vous permettent d'ajouter plusieurs éléments similaires **items** à une liste. Utilisez le **items** mot-clé pour décrire le type des éléments, etc.

#### Chaîne

Juste du texte brut. Vous pouvez le préremplir en utilisant le **par défaut** mot-clé.

Pour autoriser uniquement certaines valeurs, vous pouvez utiliser le **enum** mot-clé.


---

# 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://docs.realmjoin.com/fr/administration-et-parametres/self-service-forms.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.
