Préremplissage et chargement d'enregistrements

Les champs peuvent être préremplis de plusieurs façons — et les enregistrements onOffice existants peuvent être chargés dans votre formulaire afin de les modifier plutôt que d'en créer de nouveaux.

Contenu

• Ordre et priorité
• Valeur par défaut
• Paramètres URL
• Charger un enregistrement avec UUID
• Valeurs forcées
• Charger automatiquement les enregistrements liés
• Filtre — quels enregistrements peuvent être chargés ?

---

Ordre et priorité

Lorsqu'un champ est prérempli de plusieurs façons, l'ordre suivant s'applique — du plus faible au plus fort :

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

Cela signifie que les valeurs imposées prévalent toujours. Les paramètres URL remplacent la valeur onOffice chargée. La valeur onOffice remplace la valeur par défaut. Si toutes les sources sont vides, le champ est également vide.

---

Valeur par défaut

Dans les paramètres du champ, tu peux définir une valeur par défaut. Si le formulaire est appelé vide (aucun enregistrement chargé, aucun paramètre URL), cette valeur apparaît préremplie.

Exemples :

• Champ immobilier « Type d'objet » → Valeur par défaut haus
• Champ à sélection multiple → séparer plusieurs valeurs par ;, par exemple interessent;eigentuemer

> 🔑 Pour les champs à sélection unique/multiple, tu dois utiliser les désignations de clés internes de l'administration onOffice — par exemple ind_Schl_2759 au lieu de « Maison ».

---

Paramètres URL

Les paramètres URL ajoutés à l'URL du formulaire vous permettent de préremplir des champs lors de l'appel. Condition préalable : l'option « Autoriser le préremplissage avec des paramètres URL » doit être activée dans les paramètres du champ (par défaut : activée).

Les paramètres URL sont ajoutés à l'URL avec ?, les suivants avec & :

https://propform.io/form/dein-slug?estate[objektart]=haus&estate[objekttyp]=einfamilienhaus

> 💡 Tu trouveras le paramètre URL spécifique pour chaque champ dans les paramètres du champ, sous la case à cocher « Autoriser le préremplissage avec des paramètres URL », sous forme d'une petite note explicative.

Schéma

modul[feldname]=wert

Sélection multiple avec plusieurs valeurs

Pour les champs à sélection multiple, tu dois utiliser des crochets et indiquer chaque valeur séparément :

?address[ArtDaten][]=Eigentuemer&address[ArtDaten][]=Investor

Critères de recherche par plage (de/à)

Pour les champs de critères de recherche avec des valeurs « de » et « à », utilisez deux traits de soulignement :

?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80

Champs booléens (cases à cocher)

Les champs booléens n'acceptent, via les paramètres URL, que 1 (pour « actif »/« true ») et 0 (pour « inactif »/« false ») :

?address[opt_in]=1
?address[newsletter_einwilligung]=1

> ⚠️ Les valeurs telles que ?feld=true, ?feld=WAHR, ?feld=ja ne sont pas reconnues comme valeurs booléennes — le champ reste alors vide. Utilisez toujours l'entier 1.

## Charger un enregistrement avec un UUID

Si vous souhaitez modifier un enregistrement onOffice existant, chargez-le via son UUID (identifiant unique universel) en tant que paramètre URL. Les UUID ne peuvent pas être devinés — personne ne peut ouvrir un autre enregistrement en manipulant l'URL.

https://propform.io/form/dein-slug?address[ID]=f4059f75-8155-4869-b244-d036c3babfd1

Conditions préalables

1. Dans l'administration onOffice : activez les champs uuid dans le module Adresses ET uuid dans le module Biens immobiliers
2. Dans les paramètres du formulaire : cochez la case « Préremplissage avec les UUID »

Paramètres URL par module (attention à la casse !)

UUID via une macro d'e-mail

Lorsque vous envoyez le lien vers le formulaire via un e-mail onOffice, les UUID sont accessibles via les macros suivantes :

_Uuidaddress    →  UUID der verknüpften Adresse
_Uuidestate     →  UUID der verknüpften Immobilie

Par exemple, un lien de modification dans un modèle d'e-mail onOffice :

https://propform.io/form/dein-slug?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate

UUID via un champ de lien dans le masque onOffice

Vous pouvez également créer un champ de lien dans votre masque d'adresse ou de bien immobilier onOffice et y insérer l'URL via une formule :

="https://propform.io/form/dein-slug?address[ID]="&[uuid]

ou pour les biens immobiliers :

="https://propform.io/form/dein-slug?estate[Id]="&[uuid]

> 💡 Dans les paramètres du formulaire, sous « Modifier les enregistrements existants », propform t'affiche les liens et formules complets, prêts à être copiés.

Valeurs imposées

Dans les paramètres du champ, tu peux définir une valeur imposée. Celle-ci :

• Est préremplie lors de l'ouverture du formulaire
• Remplace les valeurs onOffice chargées
• Remplace les paramètres URL
• N'autorise l'envoi que si la valeur du champ correspond exactement à cette valeur

Séparez plusieurs valeurs à l'aide de ;.

> 💡 Exemple d'utilisation : vous créez un formulaire « Inscription à la newsletter en un clic ». Définissez une valeur imposée de aktiv pour le champ de la newsletter et combinez-la avec « Masquer le champ » + « Envoi automatique ». Le visiteur clique une fois sur le lien, le formulaire est immédiatement envoyé et le statut de la newsletter passe à aktiv.

Charger automatiquement les enregistrements associés

Lorsque vous chargez un bien immobilier via son UUID, propform peut charger automatiquement l'adresse associée — par exemple, celle du propriétaire.

Dans les paramètres du formulaire, vous trouverez une sélection à cet effet sous « Modifier les enregistrements existants » :

> ⚠️ Ne fonctionne que si un seul côté (adresse OU bien immobilier) est explicitement chargé via UUID. Si tu charges les deux via UUID, ce sont les UUID explicitement indiqués qui prévalent.

Filtres — quels enregistrements peuvent être chargés ?

Afin d’éviter que n’importe quel enregistrement puisse être modifié via le formulaire, tu peux restreindre l’accès dans les paramètres du formulaire sous « Paramètres de filtrage » :

• Filtre d'adresse : seules les adresses correspondant au filtre onOffice sélectionné peuvent être chargées
• Filtre de biens immobiliers : de même pour les biens immobiliers

Les filtres doivent avoir été créés au préalable dans votre administration onOffice (les filtres sont une fonctionnalité standard d'onOffice).

> 💡 Cas d'utilisation : vous créez un formulaire de renseignements sur le locataire qui ne doit être utilisable que pour les offres de location actives. Créez un filtre « Offres de location actives » dans onOffice et sélectionnez-le dans les paramètres du formulaire — dès lors, les biens immobiliers inactifs ne pourront plus être chargés via le lien du formulaire, même si quelqu'un connaît l'UUID.

📖 En savoir plus sur la protection par filtre : Filtres par formulaire.

Cas particuliers et consignes de sécurité

Paramètres URL dans la configuration iFrame

Si vous intégrez le formulaire à votre site web via un iFrame, les paramètres URL ?param=value doivent être placés dans l’URL de l’iFrame, et non dans l’URL du site web parent :

<!-- ✓ Richtig: Parameter im iframe-src -->
<iframe src="https://formular.deine-domain.de/dein-formular?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate"></iframe>

<!-- ✗ Falsch: Parameter in Eltern-URL kommen NICHT im iFrame an -->
<iframe src="https://formular.deine-domain.de/dein-formular"></iframe>

Si vous disposez d'une configuration iFrame dynamique (les paramètres doivent changer en fonction de l'enregistrement), la logique de votre site web doit générer dynamiquement les attributs src de l'iFrame.

Aspects de sécurité liés aux valeurs préremplies dans l'URL

Les paramètres URL sont visibles en clair — l'utilisateur peut les manipuler à sa guise avant d'envoyer le formulaire :

• ?searchcriteria[kaufpreis_bis]=500000 peut être modifié en ?searchcriteria[kaufpreis_bis]=999999999
• ?address[Sonstige1]=info@firma.de peut être modifié pour indiquer n'importe quelle autre adresse e-mail

Conséquences :

• Ne vous fiez pas aux valeurs d'URL pour les champs critiques (par exemple, tarification, taux de commission)
• Pour ces valeurs → utilisez des valeurs imposées (voir ci-dessus) — celles-ci remplacent les paramètres d'URL et ne peuvent être configurées qu'à un seul endroit
• En cas d'UUID manipulés → utilisez la protection par filtre (voir ci-dessus) afin que les utilisateurs ne puissent pas accéder à d'autres enregistrements

« Le lien est supprimé par les fournisseurs de messagerie »

Lorsque des paramètres d'URL longs (par exemple, des liens de préremplissage complexes) sont envoyés dans des e-mails, certains fournisseurs de messagerie peuvent marquer ces liens comme suspects et, par exemple, les supprimer ou les rediriger automatiquement (Microsoft Defender, Google Safe Browsing).

Options de solution :

• Utiliser son propre domaine personnalisé pour l'envoi d'e-mails → meilleure réputation
• Envoyer les liens complexes via un modèle onOffice, et non directement dans un e-mail propform
• Maintenir correctement les paramètres SPF/DKIM/DMARC

Continuer vers les macros propform 👉