> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/requests/widget.md).

# Implémenter un widget d’exercice des droits

Intégrez un formulaire d’exercice des droits personnalisable sur votre site web : apparence, champs, langues, textes et modes d’intégration.

Le widget Dastra ajoute un formulaire d’exercice des droits directement sur votre site web. Dans l’application, il se gère depuis **Demandes** > **Formulaires de collecte** : cliquez sur **Créer un formulaire** pour en ajouter un.

Il est personnalisable sur cinq points :

* **Configuration générale** : types de droits proposés, redirections, politique de confidentialité.
* **Personnalisation visuelle** : couleurs, logo, image de fond, icônes, police, barre de progression.
* **Champs** : champs standards et champs personnalisés, obligatoires ou facultatifs.
* **Modes d’intégration** : insertion dans une page, fenêtre modale (popup), iframe ou page web dédiée.
* **Multilingue** : traduction et adaptation de tous les textes du widget.

***

## Workflow d’intégration

Voici le schéma général du fonctionnement d’un widget d’exercice de droits dans Dastra :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-511537a7379a374a4c64b75283bcf0dabb6a4e96%2Fdsr-request-workflow-sequence-diagram.png?alt=media" alt="Diagramme de séquence : la personne concernée soumet sa demande par le widget et valide son adresse e-mail, puis Dastra notifie les utilisateurs, qui traitent la demande et répondent dans l’espace demandeur"><figcaption><p>Le parcours d’une demande collectée par le widget</p></figcaption></figure>

Ce diagramme illustre le processus :

1. La personne concernée soumet une demande via le widget.
2. La demande est transmise et enregistrée dans Dastra.
3. Vous êtes notifiés et pouvez la qualifier et la traiter dans la plateforme.
4. La personne concernée reçoit une réponse via le portail demandeur.

***

## Configuration générale

Ouvrez un formulaire de collecte, section **Configuration**. Vous y définissez :

* Le **nom** du widget et son **unité organisationnelle**.
* Les types de droits disponibles, avec la question **Pour quels types de droit ?** : **Types de droit par défaut**, **Certains types de droit** (vous choisissez alors les types dans **Choisir les types de demande autorisés**) ou **Aucun type de droit (formulaire simple)**, qui ne demande pas de type de droit à la personne.
* Les liens **Lien de redirection dans le cas d'un succès (après la phase d'identification)**, **Lien de redirection dans le cas d'une erreur (ex: expiration du lien de validation)** et **Lien vers la politique de confidentialité**. Ces trois liens sont facultatifs.
* **Activer la validation du téléphone**, affiché uniquement lorsque la [vérification du demandeur par SMS](https://doc.dastra.eu/features/requests/advanced/requester-space.md#verifier-le-demandeur-par-sms) est activée dans l'espace de travail : le champ téléphone devient obligatoire et le numéro est vérifié par SMS après la validation de l'adresse e-mail.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-7322a61c68a2a0688388042a32fcd0bedb715e74%2Frequests-widget-2.png?alt=media" alt="Section Configuration d’un formulaire de collecte : nom, unité organisationnelle, types de droits et liens de redirection"><figcaption><p>Configuration du widget</p></figcaption></figure>

***

## Personnalisation de l’apparence

La section **Apparence & design** adapte le formulaire à votre charte graphique. L’aperçu se met à jour pendant vos modifications.

Options disponibles :

* **Logo**, et **Image de fond** (proposée avec la disposition d’en-tête **Image de fond** ou avec le mode page web dédiée).
* Couleurs : **Couleur primaire du formulaire**, **Couleur secondaire** (avec la disposition d’en-tête **Complet**), **Couleur des titres**, **Couleur du texte** et **Couleur atténuée**.
* **Disposition de l'en-tête** : **Complet**, **Plat**, **Image de fond** ou **Pas d'en-tête**.
* **Ombre du formulaire** : **Large**, **Standard** ou **Pas d'ombre**.
* **Apparence des icônes** : **Aucune icône** ou **Icônes standards**.
* **Afficher la barre de progression**.
* **Nom de la police de caractères** : le nom d’une police installée sur votre site.
* **CSS personnalisé**, pour les utilisateurs avertis.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-d63a2a38dbe588dd2a9620982fd2825371e9073f%2Frequests-widget-3.png?alt=media" alt="Section Apparence &#x26; design avec l’aperçu du formulaire et les options de personnalisation"><figcaption><p>Adaptez l'apparence du widget</p></figcaption></figure>

***

## Personnalisation des champs

La section **Personnalisation du formulaire** liste les **Champs actifs** à gauche et les **Champs disponibles** à droite. Cliquez sur un champ disponible pour l’ajouter, glissez les champs actifs pour changer leur ordre et cliquez sur un champ actif pour le modifier.

* L’adresse e-mail est toujours présente. Par défaut, le formulaire demande aussi le prénom, le nom, la référence de la demande et le message.
* Vous pouvez ajouter des champs standards : téléphone, adresse, code postal, ville, pays, pièces jointes et catégorie de personne.
* Vous pouvez ajouter vos propres **champs personnalisés**, créés dans les champs personnalisés des demandes.
* Chaque champ dispose d’un interrupteur **Obligatoire**.
* Pour le champ **Catégorie de personnes**, cliquez sur **Configurez les catégories** pour choisir les catégories proposées à la personne.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-969470b3f336ca9da09c402260d80b3b3e00c409%2Frequests-widget-4.png?alt=media" alt="Section Personnalisation du formulaire avec les champs actifs et les champs disponibles"><figcaption><p>Personnalisez les champs disponibles dans le widget</p></figcaption></figure>

***

## Logique conditionnelle (skip logic)

Pour chaque champ, vous choisissez quand il s’affiche : **Afficher toujours**, **Afficher en fonction du type de demande** ou **Conditions d'affichage personnalisées**. Avec les conditions personnalisées, un champ apparaît uniquement si la réponse à une question précédente remplit une condition définie.

Les opérateurs proposés dépendent du type du champ, comme dans les règles de workflow :

* comparaisons (inférieur à, supérieur à et leurs variantes inclusives) pour les nombres et les dates ;
* « appartient à » et « n'appartient pas à » pour les listes déroulantes et les boutons radio ;
* « contient tous », « exclut tous », « est vide » et « n'est pas vide » pour les cases à cocher ;
* présence ou absence de valeur pour les champs facultatifs.

L'aperçu du formulaire applique ces règles. Elles sont interprétées dynamiquement côté répondant : le formulaire s'adapte en temps réel à mesure que les réponses sont saisies.

Vous pouvez ainsi :

* Afficher ou masquer des champs selon le type de droit exercé, la nature de la demande ou toute réponse antérieure
* Gérer plusieurs scénarios au sein d'un **widget unique**, sans créer et maintenir un formulaire distinct par variante
* Réduire la charge de maintenance lors des évolutions de contenu ou des exigences de conformité

***

## Installation du widget

La section **Installation** propose quatre modes d’intégration, à choisir avec **Type d'affichage du formulaire** :

* **Intégré dans la page** : un snippet HTML à placer à l’endroit où le formulaire doit apparaître.
* **Fenêtre modale (popup)** : un bouton ouvre le formulaire dans une fenêtre.
* **Page web dédiée (URL fournie)** : Dastra héberge une page dont vous partagez l’URL, par exemple dans votre politique de confidentialité.
* **Intégré dans une Iframe** : une iframe à placer dans votre page. L’option **Redimensionner l'iframe automatiquement** évite l’apparition d’une barre de défilement ; sinon, la hauteur est fixée à 1000 px.

Le code fourni est un snippet HTML et un script JavaScript à insérer sur votre site ou dans un gestionnaire de tags (par exemple Google Tag Manager). Pour les options avancées (langue, préremplissage des champs, plusieurs widgets dans une page), voir [Intégration technique](https://doc.dastra.eu/features/requests/integration.md).

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-97c3ffc004792924e71b5c50e35f5f7afac82ec8%2Frequests-widget-5.png?alt=media" alt="Section Installation avec les quatre modes d’intégration et le code à copier"><figcaption><p>Guide d'installation</p></figcaption></figure>

***

## Textes et traductions

Le widget est multilingue : dans la section **Textes et traductions**, ajoutez des langues avec **Ajouter la langue** et personnalisez les traductions.\
La première langue de la liste est la langue par défaut : Dastra l’utilise quand la langue du navigateur de la personne n’est pas disponible.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-b78e5bb2fd03240ec4b083e62dbee0ed444aab99%2Frequests-widget-6.png?alt=media" alt="Liste des langues du widget avec la langue par défaut"><figcaption><p>Personnalisation des textes du widget</p></figcaption></figure>

Pour chaque langue, cliquez sur **Modifier** pour ouvrir les textes, regroupés en quatre sections (paramètres généraux, types de droit, formulaire de contact et champs personnalisés). Vous pouvez modifier :

* Nom de la page (en cas d’intégration en page dédiée).
* Messages avant les liens de politique de confidentialité.
* Textes de boutons ou d’instructions.
* Traduction des catégories de personnes et des champs personnalisés (libellé, description, texte indicatif et options).

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-0b4fb5a2dc1d77daa42e235c65222ecdbad47fc3%2Frequests-widget-7.png?alt=media" alt="Édition des textes d’une langue du widget"><figcaption><p>Modifiez une partie des textes</p></figcaption></figure>

***

## Résultat côté utilisateur

Le widget ainsi configuré permet aux personnes concernées de sélectionner le type de droit qu’elles souhaitent exercer et de soumettre leur demande.\
Le formulaire s’adapte à la configuration (langues, apparence, champs).

À la fin du formulaire, le demandeur reçoit un e-mail avec un lien de validation et un code à 6 chiffres, et saisit le code dans le formulaire : **Saisissez le code à 6 chiffres que vous venez de recevoir par e-mail**. La demande n'est prise en compte qu'une fois l'adresse validée. Consultez la [FAQ](https://doc.dastra.eu/features/requests/faq.md).


---

# 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://doc.dastra.eu/features/requests/widget.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.
