🔗 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

Sprachversion einer Immobilie (Multilanguage)

Nutzt dein onOffice-Account das Zusatzmodul „Mehrsprachige Immobilien", kannst du mit dem Parameter estatelanguage gezielt eine Sprachversion der Immobilie laden und bearbeiten:

?estate[Id]=_Uuidestate&estatelanguage=ENG
  • Beim Laden werden die sprachabhängigen Freitexte (z.B. Objekttitel, Objektbeschreibung, Lage) der gewählten Sprachversion vorausgefüllt.
  • Beim Absenden schreibt propform die Freitexte auch wieder in genau diese Sprachversion — die Hauptsprache bleibt unberührt. Das gilt auch für KI-Texte: So kannst du z.B. eine englische Objektbeschreibung direkt in die englische Sprachversion generieren lassen.

Der Wert ist der dreibuchstabige Sprachcode von onOffice, z.B. DEU, ENG, FRA, ESP, ITA, NLD, POL.

💡 Immer die UUID der Hauptsprache verwenden — die Sprachversion wird ausschließlich über den estatelanguage-Parameter angesprochen, nicht über eine eigene UUID.

⚠️ Voraussetzungen: Das Multilanguage-Modul ist ein kostenpflichtiges onOffice-Zusatzmodul, und die Sprachversion muss in onOffice bereits angelegt sein (in der Immobilie unten rechts über „Multi language") — Formulare können keine neuen Sprachversionen erstellen.

Kein Risiko bei falscher Verwendung: Hat dein Account das Modul nicht oder existiert die angefragte Sprachversion nicht, zeigt und schreibt das Formular wie gewohnt die Hauptsprache — es geht nichts verloren.

🔑 Alle Felder außer den Freitexten (Preis, Fläche, Adresse etc.) sind zwischen den Sprachversionen synchron — sie werden unabhängig vom Sprachparameter ganz normal gelesen und geschrieben.


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 👉