🔗 Panoramica dei parametri URL

Tutti i parametri URL che puoi aggiungere a un link del modulo propform — come riferimento.

I parametri URL vengono aggiunti al link del modulo con ?, mentre ulteriori parametri URL con &.

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

Contenuto

---

Carica record — UUID

Carica un record onOffice esistente nel modulo per la modifica.

Modulo Parametro URL
Indirizzo address[ID]=f4059f75-8155-4869-... (UUID)
Immobile estate[Id]=bf0910b4-2a1e-4d51-... (UUID)
Attività agentsLog[id]=123456 (ID)
Compito task[id]=123456 (ID)
Appuntamento calendar[id]=... (crittografato)
Criterio di ricerca searchcriteria[id]=... (crittografato)
Progetto project[id]=123456 (ID)

> ⚠️ Ortografia diversa: > - Indirizzo: [ID] (I maiuscola, D maiuscola) > - Immobile: [Id] (I maiuscola, d minuscola) > - Attività, compito ecc.: [id] (minuscola)

> 🔒 Indirizzi e immobili vengono caricati esclusivamente tramite UUID — il numero interno del record non funziona (protezione di sicurezza contro la manipolazione degli URL).

> 💡 Nell'amministrazione di onOffice devi prima attivare i campi uuid (indirizzi in Dati anagrafici, immobili in Dati tecnici). Nelle impostazioni del modulo, spuntare anche "Precompilazione con UUID".

Macro onOffice per UUID

Da inserire direttamente nei modelli di e-mail onOffice o nei campi link:

Macro Significato
_Uuidaddress UUID dell'indirizzo collegato
_Uuidestate UUID dell'immobile collegato

Versione linguistica di un immobile (Multilanguage)

Se il tuo account onOffice utilizza il modulo aggiuntivo «Immobili multilingua», con il parametro estatelanguage puoi caricare e modificare in modo mirato una versione linguistica dell'immobile:

?estate[Id]=_Uuidestate&estatelanguage=ENG
  • Al caricamento, i testi liberi dipendenti dalla lingua (ad es. titolo dell'oggetto, descrizione dell'oggetto, ubicazione) vengono precompilati con i contenuti della versione linguistica scelta.
  • All'invio, propform riscrive i testi liberi esattamente in questa versione linguistica — la lingua principale rimane intatta. Questo vale anche per i testi IA: puoi ad esempio far generare una descrizione dell'oggetto in inglese direttamente nella versione linguistica inglese.

Il valore è il codice lingua di tre lettere di onOffice, ad es. DEU, ENG, FRA, ESP, ITA, NLD, POL.

💡 Utilizza sempre l'UUID della lingua principale — la versione linguistica viene richiamata esclusivamente tramite il parametro estatelanguage, non tramite un proprio UUID.

⚠️ Prerequisiti: il modulo Multilanguage è un modulo aggiuntivo onOffice a pagamento e la versione linguistica deve essere già stata creata in onOffice (nell'immobile, in basso a destra, tramite «Multi language») — i moduli non possono creare nuove versioni linguistiche.

Nessun rischio in caso di utilizzo errato: se il tuo account non dispone del modulo aggiuntivo o la versione linguistica richiesta non esiste, il modulo mostra e scrive come di consueto la lingua principale — non va perso nulla.

🔑 Tutti i campi tranne i testi liberi (prezzo, superficie, indirizzo ecc.) sono sincronizzati tra le versioni linguistiche — vengono letti e scritti normalmente, indipendentemente dal parametro della lingua.


Precompilazione dei campi

modul[feldname]=wert

Schema per modulo

Modulo Prefisso Esempio
Immobile estate ?estate[objektart]=haus
Indirizzo address ?address[Vorname]=Max
Attività agentsLog ?agentsLog[actionkind]=Linkklick
Compito task ?task[subject]=Anfrage%20pruefen
Data calendar ?calendar[subject]=Besichtigung
Criterio di ricerca searchcriteria ?searchcriteria[objektart]=wohnung
Progetto project ?project[name]=Akquise%202026

Prerequisiti

Nelle impostazioni dei campi deve essere attivata l'opzione "Consenti precompilazione con parametri URL" (impostazione predefinita).

Valori con caratteri speciali

Utilizzare la codifica URL — gli spazi diventano %20, le dieresi vengono codificate. La maggior parte dei browser lo fa automaticamente.


Parametri di protezione

Password del modulo

?key=geheim123

Il valore è la chiave memorizzata nelle impostazioni del modulo. Necessario solo se l'opzione "Password del modulo" è attiva.

Data di scadenza

?exp=2030-12-31 23:59:59

Formato: YYYY-MM-DD HH:MM:SS. La data deve essere futura. Attivare nelle impostazioni del modulo tramite "Data di scadenza obbligatoria". Maggiori informazioni su Account → Data di scadenza.

Data di scadenza dinamica tramite formula onOffice

?exp=_calculate(DATEADD(TODAY();14;"d"))
?exp=_calculate(DATEADD(TODAY();14;"d")) 16:00:00

→ Il modulo è valido per 14 giorni dall'invio dell'e-mail.


Criteri di ricerca intervallo (da/a)

I campi dei criteri di ricerca con valori Da/A utilizzano il doppio trattino basso:

?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80
?searchcriteria[kaufpreis__von]=200000&searchcriteria[kaufpreis__bis]=500000
?searchcriteria[zimmer__von]=3&searchcriteria[zimmer__bis]=5

Selezione multipla con più valori

Nei campi a selezione multipla, i valori vengono specificati con doppie parentesi quadre e un parametro URL per ciascun valore:

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

Nei campi a selezione singola/multipla, i valori devono corrispondere al nome chiave interno dell'amministrazione di onOffice — ad es. ind_Schl_2759 invece di "Casa".


Parametri di comportamento speciali

Invio automatico

Attivabile tramite le impostazioni del modulo (non tramite parametri URL), ma spesso utilizzato in combinazione con i parametri URL:

?address[ID]=_Uuidaddress&address[newsletter_aktiv]=1

→ Carica indirizzo, attiva newsletter, invia immediatamente, passa alla pagina di ringraziamento.

Combinare più parametri URL

Collegare con &:

?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate&exp=2030-12-31&key=secret123

Torna alla panoramica 👉