Precompilazione e caricamento dei record

I campi possono essere precompilati in diversi modi — ed è possibile caricare nel modulo i record esistenti di onOffice per modificarli invece di crearne di nuovi.

Contenuto

• Ordine e priorità
• Valore predefinito
• Parametri URL
• Caricare record con UUID
• Valori forzati
• Caricare automaticamente i record collegati
• Filtro — quali record sono caricabili?

---

Ordine e priorità

Se un campo viene precompilato in più modi, si applica la seguente sequenza — da debole a forte:

> Default-Wert ← sovrascritto da ← Wert aus onOffice-Datensatz ← sovrascritto da ← URL-Parameter ← sovrascritto da ← Erzwungener Wert

Ciò significa che i valori forzati hanno sempre la precedenza. I parametri URL sovrascrivono il valore onOffice caricato. Il valore onOffice sovrascrive il valore predefinito. Se tutte le fonti sono vuote, anche il campo è vuoto.

---

Valore predefinito

Nelle impostazioni del campo puoi inserire un valore predefinito. Se il modulo viene richiamato vuoto (nessun record caricato, nessun parametro URL), questo valore appare precompilato.

Esempi:

• Campo immobiliare "Tipo di oggetto" → Predefinito haus
• Campo a selezione multipla → separare più valori con ;, ad es. interessent;eigentuemer

> 🔑 Per i campi a selezione singola/multipla devi utilizzare le denominazioni chiave interne dall'amministrazione di onOffice — ad es. ind_Schl_2759 invece di "Casa".

---

Parametri URL

Con i parametri URL nell'URL del modulo puoi compilare i campi al momento della chiamata. Prerequisito: nelle impostazioni del campo è attiva l'opzione „Consenti precompilazione con parametri URL" (impostazione predefinita: attiva).

I parametri URL vengono aggiunti all'URL con ?, gli altri con &:

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

> 💡 Il parametro URL specifico per ogni campo è riportato nelle impostazioni del campo sotto il segno di spunta "Consenti precompilazione con parametri URL" come breve testo di riferimento.

Schema

modul[feldname]=wert

Selezione multipla con più valori

Per i campi a selezione multipla devi utilizzare parentesi quadre e specificare ogni valore singolarmente:

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

Criteri di ricerca intervallo (da/a)

Per i campi dei criteri di ricerca con valori da/a, usa il doppio trattino basso:

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

Campi booleani (caselle di controllo)

I campi booleani accettano tramite parametri URL esclusivamente 1 (per "attivo"/"true") e 0 (per "inattivo"/"false"):

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

> ⚠️ Valori come ?feld=true, ?feld=WAHR, ?feld=ja non vengono riconosciuti come valori booleani — il campo rimane quindi vuoto. Utilizza sempre l'intero 1.

Caricare un record con UUID

Se desideri modificare un record onOffice esistente, caricalo tramite il suo UUID (identificatore univoco universale) come parametro URL. Gli UUID non possono essere indovinati — nessuno può aprire un altro record manipolando l'URL.

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

Prerequisiti

1. Nell'Amministrazione onOffice: attivare i campi uuid nel modulo Indirizzi E uuid nel modulo Immobili
2. Nelle Impostazioni del modulo: selezionare la casella "Precompilazione con UUID"

Parametri URL per modulo (rispettare le maiuscole/minuscole!)

UUID tramite macro e-mail

Se invii il link al modulo tramite e-mail onOffice, gli UUID sono accessibili tramite le seguenti macro:

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

Ad esempio, un link di modifica in un modello di e-mail onOffice:

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

UUID tramite campo link nella maschera onOffice

Puoi anche creare un campo link nella tua maschera indirizzi o immobili onOffice e inserire l'URL tramite formula:

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

oppure per gli immobili:

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

> 💡 Nelle impostazioni del modulo alla voce "Modifica record esistenti", propform ti mostra i link e le formule completi pronti per essere copiati.

Valori obbligatori

Nelle impostazioni del campo puoi inserire un valore obbligatorio. Questo:

• Viene precompilato al momento della chiamata
• Sovrascrive i valori onOffice caricati
• Sovrascrive i parametri URL
• Consente l'invio solo se il valore del campo corrisponde esattamente a questo valore

Separa più valori con ;.

> 💡 Esempio di applicazione: stai creando un modulo "Iscrizione alla newsletter con un clic". Imposta un valore obbligatorio per il campo della newsletter su aktiv e combinalo con "Nascondi campo" + "Invio automatico". Il visitatore clicca una volta sul link, il modulo viene inviato immediatamente e lo stato della newsletter è aktiv.

Caricare automaticamente i record associati

Quando carichi un immobile tramite UUID, propform può caricare automaticamente anche l'indirizzo collegato, ad esempio il proprietario.

Nelle impostazioni del modulo, alla voce "Modifica record esistenti", troverai una selezione a questo scopo:

> ⚠️ Funziona solo se viene caricata esplicitamente una sola parte (indirizzo OPPURE immobile) tramite UUID. Se carichi entrambi tramite UUID, prevalgono gli UUID specificati esplicitamente.

Filtro — quali record sono caricabili?

Affinché non sia possibile modificare qualsiasi record con il modulo, puoi limitare le impostazioni del modulo alla voce "Impostazioni filtro":

• Filtro indirizzi: sono caricabili solo gli indirizzi che rientrano nel filtro onOffice selezionato
• Filtro immobili: analogamente per gli immobili

I filtri devono essere stati creati in precedenza nella tua amministrazione onOffice (i filtri sono una funzionalità standard di onOffice).

> 💡 Caso d'uso: stai creando un modulo di auto-informativa per gli inquilini che deve essere utilizzabile solo per le offerte di locazione attive. Crea in onOffice un filtro "Offerte di locazione attive" e selezionalo nelle impostazioni del modulo: in questo modo gli immobili non attivi non potranno essere caricati tramite il link del modulo, anche se qualcuno conosce l'UUID.

📖 Maggiori informazioni sulla protezione tramite filtri: Filtri per modulo.

Casi limite e note sulla sicurezza

Parametri URL nella configurazione iFrame

Se integri il modulo nel tuo sito web tramite iFrame, i parametri URL ?param=value devono essere inseriti nell'URL dell'iFrame, non nell'URL del sito web principale:

<!-- ✓ 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>

Se hai una configurazione iFrame dinamica (i parametri devono cambiare a seconda del record), la logica del tuo sito web deve generare dinamicamente gli attributi src dell'iFrame.

Aspetti di sicurezza relativi ai valori precompilati nell'URL

I parametri URL sono visibili in chiaro — l'utente può manipolarli a piacimento prima di inviare il modulo:

• ?searchcriteria[kaufpreis_bis]=500000 può essere modificato in ?searchcriteria[kaufpreis_bis]=999999999
• ?address[Sonstige1]=info@firma.de può essere modificato in qualsiasi altro indirizzo e-mail

Conseguenze:

• Non fare affidamento sui valori URL per i campi critici (ad es. prezzi, tassi di commissione)
• Per tali valori → utilizzare valori forzati (vedi sopra) — questi sovrascrivono i parametri URL e possono essere configurati in un unico punto
• In caso di UUID manipolati → utilizzare la protezione tramite filtro (vedi sopra), in modo che gli utenti non possano accedere ad altri record

"Il link viene cancellato dai provider di posta elettronica"

Quando si inviano parametri URL lunghi (ad es. link di precompilazione complessi) nelle e-mail, alcuni provider di posta elettronica potrebbero contrassegnare i link come sospetti e, ad esempio, rimuoverli o reindirizzarli automaticamente (Microsoft Defender, Google Safe Browsing).

Opzioni di soluzione:

• Utilizzare un dominio personalizzato per l'invio di e-mail → migliore reputazione
• Inviare link complessi tramite il modello onOffice, non direttamente nell'e-mail di propform
• Gestire correttamente SPF/DKIM/DMARC

Vai alle macro di propform 👉