Champs

Les champs sont les éléments constitutifs de votre formulaire. Ils peuvent lire des données (à partir d'un enregistrement onOffice chargé), afficher (les données saisies par l'utilisateur du formulaire) et enregistrer (dans un nouvel enregistrement onOffice ou un enregistrement existant) lors de l'envoi.

Cette page offre un aperçu de tous les types de champs disponibles et de leurs options. Dans la vidéo de démarrage rapide « Modifier un formulaire et ses champs », vous découvrirez les principales fonctionnalités en 5 minutes.

Sommaire

• Ajouter un champ
• Aperçu des types de champs
• Paramètres des champs — Libellé et remarques
• Paramètres des champs — Comportement dans le formulaire
• Paramètres des champs — Préremplissage & valeurs
• Champs numériques & curseurs de plage
• Champs à sélection unique & multiple
• Champs de téléchargement de fichiers
• Champs de téléchargement de fichiers
• Champs de critères de recherche & extension régionale
• Types spéciaux — Titre, description, image, vidéo, accordéon, ligne de séparation, saut de ligne, bouton de lien, ChatGPT
• Champ de connexion d'ensemble de données

Ajouter un champ

Une fois que tu as enregistré un formulaire, tu trouveras la liste des champs dans les paramètres du formulaire. Clique sur « Ajouter un champ » pour créer un nouveau champ.

Vous pouvez organiser les champs dans l'ordre souhaité par glisser-déposer. En cliquant sur l'icône en forme de crayon, vous ouvrez les paramètres du champ.

> 💡 Les champs peuvent être ajoutés plusieurs fois. Si vous avez deux champs identiques (même type de champ + même nom de champ) dans le formulaire, seul le dernier sera utilisé lors de l'envoi.

---

Aperçu des types de champs

Lors de la création d’un champ, vous sélectionnez d’abord le type de champ. Ce choix détermine la fonction du champ et les options supplémentaires disponibles.

Modules onOffice

> Les champs individuels disponibles dans chaque module proviennent directement de votre administration onOffice. Si un champ manque, vérifiez dans onOffice sous Outils → Paramètres → Administration si le champ y est activé.

Types spéciaux (pas de modules onOffice)

Paramètres du champ — Libellé et remarques

Dans l'onglet « Libellé », vous définissez le libellé du champ dans le formulaire :

• Libellé : ce qui s'affiche comme étiquette au-dessus ou à côté du champ. Si ce champ est vide, le nom du champ est repris depuis l'administration onOffice. Macros activées — par exemple « Bonjour _Vorname, que cherches-tu ? ».
• Remarque : petit texte d'aide sous le champ. Macros activées.
• Placeholder : texte gris par défaut dans le champ, disparaît lors de la saisie. Macros activées.
• Tooltip : s'affiche lorsque l'on survole le champ (petite icône « ? »). Macros activées.
• Liste de données : valeurs suggérées (séparées par ;) que le navigateur affiche en suggestion automatique lors de la saisie.

Paramètres du champ — Comportement dans le formulaire

• Champ obligatoire : le formulaire ne peut être envoyé que si le champ est renseigné.
• Masquer le champ : le champ est invisible dans le formulaire, mais il est tout de même envoyé avec son contenu. Pratique en combinaison avec des valeurs par défaut ou obligatoires.
• Verrouiller le champ (lecture seule) : le contenu ne peut pas être modifié par le visiteur, il est grisé. Il est tout de même envoyé.
• Désactiver le champ (disabled) : comme le verrouillage, mais n'est pas envoyé — la valeur est perdue.
• Réduire la largeur du champ de moitié : sur les grands écrans, le champ s'affiche avec une largeur réduite de moitié — si deux champs consécutifs ont tous deux cette option, ils s'affichent côte à côte.
• Saisie semi-automatique du navigateur : Activez cette option pour les champs tels que Nom/E-mail/Téléphone afin que le navigateur propose des valeurs issues de sa mémoire.

Paramètres des champs — Préremplissage et valeurs

Quelles sont les valeurs de préremplissage d'un champ ? Il existe quatre sources, classées par ordre de priorité de faible à forte :

> Default-Wert ← remplacé par ← Wert aus onOffice-Datensatz ← remplacé par ← URL-Parameter ← remplacé par ← Erzwungener Wert

• Valeur par défaut : s'affiche lorsque le formulaire est ouvert vide.
• Autoriser le préremplissage avec des paramètres URL (par défaut : activé) : permet de préremplir le champ via ?modul[feldname]=wert.
• Valeurs obligatoires : Remplace tout. De plus, l'envoi n'est possible que si la valeur correspond exactement à la valeur obligatoire. Séparez les valeurs multiples par ;.
• Valeurs autorisées : Une liste de valeurs autorisées (séparées par ;). Le formulaire ne peut être envoyé que si la valeur du champ correspond à l'une d'entre elles. En cas de sélection simple/multiple, seules ces options s'affichent.

> 🔑 Important pour la sélection simple/multiple : vous devez utiliser les désignations de clés internes issues de l'administration onOffice — par exemple ind_Schl_2759, et non le texte en clair affiché.

Plus de détails : Préremplissage et chargement des enregistrements.

---

Champs numériques et curseurs de plage

Pour les champs numériques (prix d'achat, surface habitable, nombre de pièces, etc.), il existe des options supplémentaires :

• Valeur minimale fixe : limite inférieure que le visiteur ne peut pas descendre en dessous.
• Valeur maximale fixe : limite supérieure.
• Intervalle : incrément — par exemple 1000 pour des incréments de mille pour le prix d'achat, 0,0001 pour 4 décimales.
• Valeur minimale = valeur onOffice actuelle + intervalle : Pratique pour les procédures d'appel d'offres — la valeur minimale est calculée dynamiquement à partir de la valeur actuelle dans onOffice plus l'intervalle.
• Afficher l'unité/la devise dans le champ : Suffixe librement définissable tel que m², €, kg, etc.
• Curseur de plage : un curseur s'affiche à la place d'un champ de saisie — avec ses propres valeurs minimale et maximale.

> 💡 Sur smartphone, le clavier numérique s'affiche automatiquement à la place du clavier alphabétique. Les séparateurs de milliers (point) sont insérés automatiquement.

Champs à sélection unique et multiple

Pour les listes de sélection (type d'objet, type de contact, type de commercialisation, etc.), il existe quelques options spéciales :

Libellés personnalisés

Au lieu des libellés onOffice d'origine, tu peux attribuer tes propres libellés aux options — par exemple « Oui »/« Non » au lieu de ja/nein, ou des traductions en anglais. Tu définis les correspondances dans les paramètres de champ pour chaque clé.

> 💡 Cas d'utilisation du multilinguisme : si vous gérez une copie de formulaire en anglais/espagnol, vous remplacez ici les libellés des clés pour chaque option (apartment → Apartamento, villa → Townhouse) — sans toucher à l'administration onOffice. Pour en savoir plus, consultez Formulaires multilingues.

Limiter les valeurs autorisées

Vous ne souhaitez pas que toutes les options soient visibles dans le formulaire ? Dans les paramètres du champ → paramètres supplémentaires du champ → « Valeurs autorisées », vous pouvez définir une liste blanche — toutes les autres options seront masquées.

Format : valeurs clés séparées par des points-virgules — par exemple ind_3673;ind_3675.

Trouver les valeurs-clés : Dans le formulaire, clic droit → Inspecter → Développer <select> → les balises <option> indiquent data-selectable-data-value (clé) + texte en clair (libellé).

> 💡 Cas particulier des champs utilisateur : pour les champs utilisateur à sélection unique (par ex. « Responsable du bien immobilier »), les clés sont des identifiants utilisateur internes tels que 23, 45. Tu ne peux les trouver que via l'astuce DevTools-Inspect — onOffice ne les affiche pas dans l'administration.

Sélection unique avec fonction de recherche

Pour les champs comportant de nombreuses options (par exemple les champs utilisateur), tu peux autoriser l'affichage d'un champ de recherche lorsque l'on clique dans le champ, permettant ainsi au visiteur de saisir des valeurs.

Modes de sélection multiple

• Normal : Par défaut. Ouvre un menu déroulant au clic, affiche la hiérarchie des options.
• Alternatif : Mode spécial pour les champs avec une grande arborescence (par ex. « Supplément régional »). Les valeurs enfants ne sont pas directement visibles dans le formulaire — mais sont automatiquement activées lors de l'enregistrement si l'élément parent est sélectionné.
• Legacy : ancien comportement, toutes les options sont présentées à un seul niveau.

Ajouter des valeurs à la sélection multiple au lieu de les remplacer

Par défaut, une soumission de sélection multiple remplace complètement la valeur existante dans onOffice — toutes les balises existantes sont remplacées. Cela est souvent indésirable pour les adresses existantes (vérification des doublons d'adresses, voir Fusionner plusieurs enregistrements) : un client qui a déjà « Type de contact = Acheteur » et qui remplit un formulaire de newsletter ne doit pas se retrouver soudainement avec uniquement « Type de contact = Newsletter ».

Solution : Dans les paramètres du formulaire → section « Écrire les valeurs », activez l'option « Ajouter / supprimer des valeurs multi-sélection ».

• Ajouter : les nouvelles valeurs sont ajoutées aux balises existantes (au lieu de les remplacer)
• Supprimer : les valeurs sont supprimées de manière ciblée de la liste des balises (par ex. désabonnement à la newsletter)
• Par défaut (remplacer) : s'applique toujours aux nouvelles adresses créées

> 💡 Différence par rapport au champ caché par défaut : le champ caché avec valeur par défaut ne s'applique qu'aux enregistrements NOUVEAUEMENT créés. Le paramètre Ajouter/Supprimer s'applique également aux enregistrements existants via la vérification des doublons — c'est exactement ce dont vous avez besoin pour les workflows de newsletter/balises.

Comportement du menu déroulant

• S'ouvre uniquement lors de la saisie : le menu déroulant n'apparaît pas au clic, mais seulement lorsque le visiteur commence à taper.
• Se ferme après la sélection : le menu déroulant se ferme après une sélection. S'il est désactivé, il reste ouvert pour permettre une sélection multiple.

Hiérarchie

Les champs à sélection multiple affichent désormais la hiérarchie des options (parent/enfant). Si vous sélectionnez un élément parent, les éléments enfants sont automatiquement cochés — et inversement.

Saisie semi-automatique entre les champs

Les champs peuvent se compléter automatiquement les uns les autres — par exemple, un champ « Prénom » qui génère des suggestions en fonction du titre et du nom de famille, ou un champ de description de profil de recherche qui est automatiquement compilé à partir de plusieurs champs.

Configuration : Paramètres des champs → Libellé → Sélection multiple « Saisie semi-automatique » → sélectionner d'autres noms de champs dans le formulaire. Lorsque vous modifiez les champs sources, la balise se complète automatiquement avec leurs valeurs.

📖 Pour en savoir plus, consultez Champs calculés.

⚠️ Anti-modèle : champs en double dans le formulaire

Si tu ajoutes le même champ deux fois dans le formulaire (par exemple, le titre en haut et en bas), c'est toujours le champ ajouté en dernier qui prévaut lors de la soumission — même s'il est vide. Cela remplace le champ du haut par rien → perte de données.

À faire à la place :

• Si tu souhaites saisir une deuxième personne (par exemple, conjoint) : utilisez les champs standard onOffice Anrede2, Vorname2, Name2, Strasse2, etc. (souvent à activer dans l'administration onOffice sous « Données de base 2 »)
• Ou créez trois champs personnalisés (anrede_2, vorname_2, name_2)

> 💡 Les champs Données de base 2 sont désactivés par défaut dans de nombreuses versions d'onOffice — avant de les utiliser dans le formulaire propform, activez-les dans onOffice sous Outils → Paramètres → Administration → Adresses.

---

Champs de téléchargement de fichiers

Sélectionnez le type de champ « Télécharger un fichier » dans un module onOffice (Adresse ou Bien immobilier). Le visiteur peut télécharger un ou plusieurs fichiers qui seront directement enregistrés dans l'enregistrement onOffice.

Paramètres de base

• Caractéristique du document (uniquement pour les biens immobiliers) : sélectionnez dans votre administration onOffice la caractéristique du document qui sera attribuée aux fichiers.
• Type de fichier (uniquement pour les biens immobiliers) : classification en Foto, Aushang, Energieausweis, Grundriss, etc. — est automatiquement mappé à l'onglet interne/externe approprié et au type de fichier standard onOffice. Valeur par défaut : « Document interne ».
• Nom du fichier lors de l'archivage : Avec des macros — par exemple _Name_Vorname ou Geldwaeschedoku_Name. En cas de téléchargement multiple, les extensions _1, _2, _3 sont automatiquement ajoutées.
• Description du fichier et texte libre (uniquement pour les biens immobiliers, premier fichier) : sont enregistrés dans le masque de fichier onOffice en tant que description et texte libre.
• Onglet interne/externe (uniquement pour les biens immobiliers) : par défaut « externe » (pour publication), au choix « interne » (visible uniquement par les collaborateurs).
• Appliquer un filigrane : option permettant d'ajouter un filigrane au fichier — ne fonctionne qu'avec les fichiers JPEG.
• Emplacement de stockage : Emplacement dans l'onglet Fichier d'onOffice.

> 💡 Adresse vs. Bien immobilier : les champs de téléchargement de fichiers dans le module Adresse offrent moins d'options (nom de fichier + texte libre) que dans le module Bien immobilier (tout ce qui précède). Il s'agit d'une spécification de l'API onOffice.

⚠️ La caractéristique de document + le téléchargement multiple sont incompatibles

Si un champ de téléchargement de fichiers est associé à une caractéristique de document, le téléchargement multiple est automatiquement limité à un seul fichier — règle de l'API onOffice : 1 caractéristique = 1 fichier.

Solutions de contournement :

• Créer plusieurs champs (par ex. « Recto de la carte d'identité » + « Verso de la carte d'identité »), chacun avec sa propre caractéristique
• Activer le regroupement ZIP/PDF (voir la section suivante) — tous les fichiers téléchargés sont regroupés en un seul qui hérite de l'attribut
• Utiliser un champ de fichier sans attribut — dans ce cas, un nombre illimité de téléchargements est possible, mais sans classification

Particularité du navigateur Apple : sur iPhone, les options de sélection unique désactivées ne sont pas masquées, mais affichées en gris (norme HTML). Si tu souhaites éviter cela : utilise « Valeurs autorisées » (liste blanche) au lieu de désactiver les options individuelles — les options non autorisées seront alors complètement supprimées du menu déroulant.

Regrouper plusieurs fichiers

Très pratique pour de nombreuses photos ou plusieurs pages PDF :

• Regroupement ZIP : tous les fichiers téléchargés sont regroupés dans un fichier ZIP. Option « uniquement pour plusieurs fichiers » — un fichier unique est téléchargé normalement.
• Regroupement PDF : plusieurs images ou fichiers PDF sont fusionnés en un seul PDF.
• Renommer les fichiers avant le regroupement : les noms de fichiers dans le ZIP/PDF suivent un modèle (macros activées).

Hybride : téléchargement ou chargement

Dans les paramètres du champ, vous pouvez également configurer un champ de fichier en tant que champ de téléchargement (pour les fichiers déjà existants dans onOffice) ou en tant qu'hybride (téléchargement + chargement).

Tablette de signature

Dans les paramètres du champ de fichier, cochez la case « Champ de signature ». Au lieu du sélecteur de fichiers standard, un tablet numérique s'affiche dans le formulaire — le visiteur signe avec la souris ou le doigt.

• La signature est enregistrée au format PNG dans le champ de fichier onOffice (et non au format PDF)
• Elle est traitée comme un fichier téléchargé (caractéristiques du document, onglets, options de filigrane disponibles)
• Les macros _dateipfadAdressfeld et _dateipfadObjektfeld vous permettent d'insérer la signature dans les modèles PDF d'onOffice — idéal pour les déclarations des locataires, les mandats d'urgence, les procurations, etc.

> 💡 Option associée : cocher « Empêcher l'ajout de pièces jointes pour les fichiers de ce champ » empêche que le fichier PNG de la signature soit joint à l'e-mail de notification — utile si la signature apparaît déjà dans le descriptif PDF et ne doit pas être envoyée en double.

📺 Voir la vidéo : 9. Ajouter un champ de signature au formulaire

> 📎 Les images HEIC provenant d'un iPhone sont automatiquement converties au format JPEG. > 📎 Limite de taille des fichiers : 128 Mo par fichier (limite nginx côté serveur). Si les fichiers individuels sont plus volumineux, l'utilisateur reçoit une erreur serveur avant le téléchargement proprement dit.

Champs de téléchargement de fichiers

Les champs de téléchargement vous permettent de mettre à disposition des visiteurs du formulaire des fichiers déjà enregistrés dans onOffice pour qu'ils puissent les télécharger. Pratique pour les espaces de données/téléchargement numériques.

📺 Voir la vidéo : 12. Télécharger des fichiers

Critères de sélection (quel fichier est téléchargé ?)

Vous choisissez parmi différents sélecteurs :

• Par caractéristique du document : caractéristique précise exactemet̆
• La caractéristique du document contient une chaîne de caractères : par exemple, tous les fichiers dont la caractéristique contient « Exposé »
• Dernier fichier de type X
• Dernier fichier dont le nom contient X
• Dernier fichier dont le titre contient X
• Tous les fichiers de type X / dont le nom contient X / dont le titre contient X
• URL externe (enregistrée de manière statique)
• Créer un PDF à partir d'un modèle onOffice (Exposé / Lettre / Formulaire)

Autres options

• Renommer le fichier lors du téléchargement : macros activées — par ex. Expose_Name_Vorname.pdf
• Masquer le champ s'il n'y a pas de fichier : si le sélecteur ne trouve pas de fichier correspondant, le champ n'est pas affiché.
• Enregistrer l'activité lors du téléchargement : Qui a téléchargé quoi et quand → Journal d'activité dans onOffice.

Champs de critères de recherche et extension régionale

Les champs du module de critères de recherche doivent être explicitement définis comme champs de critères de recherche dans l'administration onOffice, sinon ils ne seront pas proposés par propform.

Champs de plage (de/à)

Les champs tels que « Surface habitable », « Prix d'achat », « Nombre de pièces » ont une valeur de départ et une valeur d'arrivée dans les critères de recherche. Vous pouvez :

• Étiquettes personnalisées : attribuer vos propres désignations à la place de « de » / « à » (par ex. « min. » / « max. »).
• Paramètres URL séparés : avec un double trait de soulignement — ?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80

Cas particulier : Supplément régional

Le champ multisélection « Supplément régional » présente souvent une arborescence très étendue (code postal, quartiers, régions). En mode « Alternatif », les éléments enfants ne s’affichent pas directement dans le formulaire, mais sont automatiquement activés lorsque l’élément parent est sélectionné. Le formulaire reste ainsi rapide et clair.

Types spéciaux

Titre

Texte long servant de titre de section. Macros activées — par exemple « Demande concernant _objektart à _ort ».

Description

Texte explicatif plus long, généralement entre les champs. Macros activées. Dans les descriptions, vous pouvez utiliser des macros propform telles que _pfButton(...) ou _pfLink(...) pour créer des boutons et des liens — voir macros propform.

> 💡 Dans les champs de description, vous pouvez également intégrer des iFrames — par exemple, une iFrame de prise de rendez-vous Timum. Pratique pour intégrer des fonctionnalités externes directement dans le formulaire.

HTML dans les champs de description

Les champs de description autorisent l'utilisation étendue du HTML — filtré via HTMLPurifier (sécurisé contre les attaques XSS, mais configuré de manière généreuse) :

• Mise en forme du texte : <strong>, <b>, <em>, <i>, <u>, <small>, <mark>, <sub>, <sup>, <s>, <ins>, <del>, <br>, <hr>, <p>, <h1>–<h6>
• Listes : <ul>, <ol> et <li>
• Tableaux : <table>, <thead>, <tbody>, <tr>, <th>, <td> (avec border, cellpadding, cellspacing, colspan, rowspan)
• Liens : <a href="..." target="_blank|_self|_top" class="..." type="...">
• Images : <img src="..." width height alt style>
• Conteneurs : <div class style>, <span class style>, <blockquote>, <cite>
• Éléments de structure HTML5 : <section>, <nav>, <article>, <aside>, <header>, <footer>, <address>, <figure>, <figcaption>
• Vidéo : <video controls preload poster> avec <source src type>
• iFrames (HTTPS uniquement, par exemple pour la prise de rendez-vous Timum, YouTube, etc.) — <iframe src width height title allow allowfullscreen frameborder>
• Attributs CSS style : largement autorisés (y compris !important, préfixes de fournisseurs, propriétés propriétaires) — tu peux définir les couleurs, les tailles, les marges, les bordures, les arrière-plans, Flexbox/Grid, les transformations, etc.

> 🔒 Sécurité : les balises <script> et les gestionnaires d'événements (onclick=, onload=, etc.) sont bloqués (protection XSS). Les iFrames ne sont autorisées que via HTTPS. Vous ne pouvez donc pas injecter n'importe quel code JavaScript.

Résolution des macros dans les champs de description : entièrement active — vous pouvez utiliser _calculate(IF(...)) pour du contenu conditionnel, intégrer dynamiquement des champs issus de l'ensemble de données, ou utiliser _pfGetSearchCriteriaInformation pour les tableaux de profils de recherche.

Saut de page

Divise le formulaire en étapes multi-étapes. Par champ de saut de page :

• Nom de l'étape GTM (pour Google Tag Manager)

Ligne de séparation

Simple ligne visuelle. Pas de contenu, uniquement pour la structure.

Bouton de lien

Bouton stylisé renvoyant vers une URL externe. Vous pouvez ajouter à l'URL les ID/UUID actuellement chargés — par exemple « Accéder au formulaire suivant avec les enregistrements nouvellement créés ». Options :

• Ajouter l'ID/UUID du bien immobilier (avec le type)
• Ajouter l'ID/UUID de l'adresse (avec le type + le type de contact)
• Ajouter l'ID du critère de recherche, de l'activité, de la tâche, du rendez-vous ou du projet
• Ouvrir dans un nouvel onglet

Image

Image intégrée via une URL externe.

Vidéo

Vidéo YouTube ou Vimeo intégrée. Pour Vimeo, il est également possible de spécifier le paramètre Privacy-Hash.

Accordéon (section repliable)

Zone repliable. Le contenu peut provenir de n'importe quel autre champ. Options :

• Titre (toujours visible)
• Statut : replié ou déplié par défaut

Champ ChatGPT

Champ spécial pour la génération de texte par IA — le visiteur saisit des données, ChatGPT génère le texte et l'écrit dans un champ onOffice. La configuration s'effectue dans les paramètres du formulaire sous « Génération de texte ChatGPT ».

Champ de liaison entre enregistrements

Si votre formulaire crée ou modifie simultanément une adresse et un bien immobilier, vous avez besoin d'une liaison entre les deux — par exemple « Propriétaire », « Acheteur », « Locataire », « Personne intéressée ».

Dans les paramètres du formulaire, vous pouvez choisir une liaison statique. Si vous avez besoin d’une liaison dynamique (par exemple en fonction d’un champ de sélection), ajoutez un champ de liaison d’enregistrements au formulaire.

Peu importe que vous choisissiez le type de champ « Bien immobilier » ou « Adresse ».

Valeurs possibles :

> 💡 Souvent, vous souhaitez combiner le champ de liaison avec « Valeur forcée » + « Masquer le champ », afin que le visiteur ne le voie pas, mais que la liaison soit tout de même établie.

Continuer vers Préremplissage et chargement des enregistrements 👉