Aller au contenu principal
DocxGen

Constructeur de formulaire

Configurer les types, options, placeholders et validations.

10 min de lecture

Le constructeur de formulaire vous permet de personnaliser l'interface de saisie pour chaque modèle. Il transforme les champs détectés dans votre document Word en un formulaire ergonomique.

Accéder au constructeur

1

Ouvrir la liste des modèles

Dans l'application, cliquez sur « Modèles » dans la barre latérale.

2

Ouvrir le menu du modèle

Sur le modèle souhaité, cliquez sur l'icône des 3 points (⋯) à droite.

3

Cliquer sur « Générer le formulaire »

Le constructeur de formulaire s'ouvre avec les champs détectés dans votre modèle.

Auto-génération

Le bouton « Auto-générer » analyse votre document Word et crée automatiquement les champs du formulaire :

  • Détection des balises : {champ}, {%image}, {#condition} sont détectés automatiquement
  • Typage intelligent : DocXgen devine le type de champ selon le nom (ex: {email} → type Email, {date_embauche} → type Date, {montant_ht} → type Montant)
  • Placeholders automatiques : un texte d'aide est généré pour chaque champ

Régénération intelligente

Si vous cliquez sur « Auto-générer » après avoir déjà configuré des champs, vos personnalisations sont conservées. Seuls les nouveaux champs sont ajoutés et les champs supprimés du modèle sont retirés.

Configurer un champ

Cliquez sur un champ pour le déplier et accéder à ses options de configuration :

Label

Le texte affiché au-dessus du champ dans le formulaire. Par défaut, il est généré à partir du nom technique (ex: nom_client → « Nom Client »). Personnalisez-le pour plus de clarté.

Type

Le type de champ détermine l'interface de saisie. Consultez le guide Types de champs pour la liste complète. Vous pouvez changer le type à tout moment.

Placeholder

Le texte d'aide grisé qui apparaît dans le champ vide. Il guide l'utilisateur sur le format attendu (ex: « ex: Jean Dupont », « ex: 06 12 34 56 78 »).

Champ obligatoire

Activez cette option pour rendre le champ obligatoire. Les champs obligatoires sont marqués d'un badge rouge « Requis » et doivent être remplis avant la génération.

Options des champs à choix

Pour les types Liste déroulante, Sélection multiple et Boutons radio, vous pouvez configurer les options proposées :

1

Ouvrir le champ

Cliquez sur le champ de type select, multiselect ou radio pour le déplier.

2

Ajouter une option

Cliquez sur « Ajouter option ». Renseignez la valeur (insérée dans le document) et le label (affiché dans le formulaire).

3

Gérer les options

Réorganisez, modifiez ou supprimez les options existantes avec les boutons correspondants.

Valeur vs Label

La valeur est le texte qui sera inséré dans le document Word. Le label est le texte affiché dans le formulaire. Exemple : valeur « CDI », label « Contrat à durée indéterminée ».

Dimensions des images

Pour les champs de type Image, vous pouvez définir les dimensions cibles en pixels (largeur × hauteur). Si vous laissez ces champs vides, l'image sera insérée aux dimensions de l'image placeholder dans votre modèle Word.

Listes dynamiques

Les listes dynamiques sont détectées automatiquement lorsqu'un bloc {#nom}...{/nom} contient au moins 2 sous-champs. Dans le constructeur de formulaire, elles sont reconnaissables à :

  • Une bordure bleue à gauche du champ
  • Un badge « Liste dynamique » affiché à côté du nom
  • Une bannière d'information qui explique que ce champ génèrera un tableau dans le formulaire de génération

En cliquant sur une liste dynamique, vous pouvez configurer chaque sous-champ (colonne) individuellement :

  • Label : le nom de la colonne affiché dans le tableau
  • Type : texte, nombre, montant, date, email... chaque colonne peut avoir un type différent

Import CSV disponible à la génération

Dans le constructeur, vous configurez la structure de la liste. Lors de la génération, l'utilisateur pourra remplir les lignes manuellement ou les importer depuis un fichier CSV/Excel. Voir le guide Listes dynamiques.

Sections conditionnelles

Les sections conditionnelles sont détectées automatiquement lorsqu'un bloc {#nom}...{/nom} contient 0 ou 1 sous-champ. Dans le constructeur de formulaire, elles sont reconnaissables à :

  • Une bordure ambrée à gauche du champ
  • Un badge « Section conditionnelle » affiché à côté du nom
  • Une bannière d'information qui explique que ce champ sera un toggle on/off dans le formulaire

Lors de la génération, la section conditionnelle apparaît comme un simple interrupteur. Si activé, le bloc est inclus dans le document final. Si désactivé, il est supprimé.

Organiser les champs

Réordonner

Utilisez les flèches ↑ et ↓ à gauche de chaque champ pour modifier l'ordre d'affichage dans le formulaire.

Supprimer

Cliquez sur l'icône corbeille pour retirer un champ du formulaire. Le champ reste dans votre modèle Word mais ne sera plus proposé dans le formulaire.

Nom du formulaire

En haut du constructeur, personnalisez le nom du formulaire. Ce nom est affiché lors de la génération pour identifier le formulaire.

Enregistrer

Cliquez sur « Enregistrer » pour sauvegarder votre configuration. Le formulaire sera utilisé à chaque génération de document depuis ce modèle.

Que se passe-t-il si j'ajoute un nouveau champ dans mon modèle Word ?

Cliquez sur « Auto-générer » dans le constructeur. Le nouveau champ sera ajouté tout en conservant la configuration des champs existants.

Puis-je avoir plusieurs formulaires pour un même modèle ?

Non, chaque modèle a un seul formulaire associé. Modifiez le formulaire existant pour l'adapter à vos besoins.

Les champs supprimés du formulaire apparaissent-ils dans le document ?

Les balises des champs supprimés du formulaire resteront telles quelles dans le document généré (non remplacées). Il est recommandé de garder tous les champs de votre modèle dans le formulaire.

Créez votre formulaire

Importez un modèle Word et configurez votre formulaire en quelques clics.