🔗 URL-Parameter-Übersicht

Alle URL-Parameter, die du an einen propform-Formularlink anhängen kannst — als Nachschlagewerk.

URL-Parameter werden mit ? an den Formularlink angehängt, weitere URL-Parameter mit &.

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

Inhalt


Datensatz laden — UUIDs

Lade einen bestehenden onOffice-Datensatz in das Formular zum Bearbeiten.

Modul URL-Parameter
Adresse address[ID]=f4059f75-8155-4869-... (UUID)
Immobilie estate[Id]=bf0910b4-2a1e-4d51-... (UUID)
Aktivität agentsLog[id]=123456 (ID)
Aufgabe task[id]=123456 (ID)
Termin calendar[id]=... (verschlüsselt)
Suchkriterium searchcriteria[id]=... (verschlüsselt)
Projekt project[id]=123456 (ID)

⚠️ Schreibweise unterschiedlich:

  • Adresse: [ID] (großes I, großes D)
  • Immobilie: [Id] (großes I, kleines d)
  • Aktivität, Aufgabe etc.: [id] (klein)

🔒 Adressen und Immobilien werden ausschließlich per UUID geladen — die interne Datensatznummer funktioniert nicht (Sicherheits-Schutz gegen URL-Manipulation).

💡 In der onOffice-Administration musst du die Felder uuid (Adressen unter Stammdaten, Immobilien unter Technische Angaben) erst aktivieren. In den Formulareinstellungen zusätzlich „Vorausfüllung mit UUIDs" anhaken.

onOffice-Makros für UUIDs

Zum direkten Einsetzen in onOffice-E-Mail-Vorlagen oder Link-Feldern:

Makro Bedeutung
_Uuidaddress UUID der verknüpften Adresse
_Uuidestate UUID der verknüpften Immobilie

Felder vorausfüllen

modul[feldname]=wert

Schema pro Modul

Modul Präfix Beispiel
Immobilie estate ?estate[objektart]=haus
Adresse address ?address[Vorname]=Max
Aktivität agentsLog ?agentsLog[actionkind]=Linkklick
Aufgabe task ?task[subject]=Anfrage%20pruefen
Termin calendar ?calendar[subject]=Besichtigung
Suchkriterium searchcriteria ?searchcriteria[objektart]=wohnung
Projekt project ?project[name]=Akquise%202026

Voraussetzung

In den Feldeinstellungen muss „Erlaube Vorausfüllung mit URL-Parametern" aktiviert sein (Standard).

Werte mit Sonderzeichen

URL-Encoding nutzen — Leerzeichen wird zu %20, Umlaute werden codiert. Die meisten Browser machen das automatisch.


Schutz-Parameter

Formular-Passwort

?key=geheim123

Wert ist der in den Formulareinstellungen hinterlegte Schlüssel. Nur erforderlich, wenn der Schalter „Formular-Passwort" aktiv ist.

Ablaufdatum

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

Format: YYYY-MM-DD HH:MM:SS. Datum muss in der Zukunft liegen. Aktivieren in den Formulareinstellungen über „Ablaufdatum erforderlich". Mehr unter Account → Ablaufdatum.

Dynamisches Ablaufdatum per onOffice-Formel

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

→ Formular ist 14 Tage ab Versand der E-Mail gültig.


Range-Suchkriterien (von/bis)

Suchkriterien-Felder mit Von/Bis-Wert verwenden doppelten Unterstrich:

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

Multiselect mit mehreren Werten

Bei Multiselect-Feldern werden mehrere Werte mit eckigen Doppel-Klammern und je einem URL-Parameter pro Wert angegeben:

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

Bei Single-/Multiselect-Feldern müssen die Werte den internen Schlüsselnamen aus der onOffice-Administration entsprechen — z.B. ind_Schl_2759 statt „Haus".


Spezielle Verhaltens-Parameter

Auto-Absenden

Per Formular-Einstellung aktivierbar (nicht per URL-Parameter), aber häufig in Kombination mit URL-Parametern genutzt:

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

→ Adresse laden, Newsletter aktiv setzen, sofort absenden, weiter zur Dankeseite.

Mehrere URL-Parameter kombinieren

Mit & verbinden:

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

Zurück zur Übersicht 👉