Suchprofile sind in onOffice ein eigenes Modul: ein Käufer/Mieter beschreibt seine Wunsch-Immobilie (Region, Objektart, Preisspanne, Wohnfläche etc.), und onOffice macht später automatische Matchings mit passenden Immobilien. propform kann komplette Suchprofile per Formular anlegen — inkl. Multi-Region, Range-Felder und automatischer Verknüpfung mit der Adresse.
_pfGetSearchCriteria*)In onOffice ist ein Suchprofil ein eigenständiger Datensatz — verbunden mit einer Adresse, aber nicht ein Feld der Adresse. Eine Adresse kann mehrere Suchprofile haben (z.B. „Suche Eigentumswohnung in Berlin" + „Suche Anlage-Mehrfamilienhaus deutschlandweit").
Konsequenz für propform:
Setup:
Typische Suchkriterien-Felder:
objektart (Wohnung / Haus / Grundstück / Gewerbe)vermarktungsart (Kauf / Miete / Pacht)kaufpreis (Range-Feld — propform zeigt automatisch zwei Eingabefelder „von" / „bis")kaltmiete (Range-Feld)wohnflaeche (Range-Feld)anzahl_zimmer (Range-Feld)regionaler_zusatz (Multi-Select Regionen)💡 Range-Felder: Die Felder oben heißen einfach
kaufpreis,wohnflaecheetc. — nichtkaufpreis_von/kaufpreis_bis. propform erkennt automatisch, dass es sich um ein Range-Feld handelt, und zeigt zwei Eingabefelder.
⚠️ Wichtig: Damit ein Feld im Suchkriterien-Modul auftaucht, muss es in onOffice explizit als Suchkriterien-Feld definiert sein (Extras → Einstellungen → Administration → Modul Suchkriterien). Sonst zeigt propform es nicht an.
Suchkriterien arbeiten typischerweise mit Range-Werten (Preis von 200.000 bis 500.000, Wohnfläche 80 bis 120 m²). Du fügst das Feld einfach mit seinem Basis-Namen hinzu (z.B. kaufpreis) — propform erkennt automatisch, dass es sich um ein Range-Feld handelt, und zeigt zwei Eingabefelder („von" / „bis").
⚠️ Range-Slider funktioniert hier nicht: Das Spezialfeld „Range Slider" gibt es nur für normale Zahlenfelder, nicht für Suchkriterien-Range-Felder. Bei Suchkriterien bleibt es bei zwei Eingabefeldern.
Bei den klassischen Suchkriterien-Feldern wie regionaler_zusatz oder objektart will der User oft mehrere Werte anhaken (z.B. „Berlin-Mitte UND Berlin-Friedrichshain"). propform macht das automatisch über das Multi-Select-Feld.
Tipps für Multi-Select bei Suchkriterien:
Es gibt in onOffice zwei grundsätzlich verschiedene Wege, eine geografische Suche aufzubauen — jede hat ihre Stärken:
User gibt eine Bezugs-Adresse (PLZ, Ort, Straße) plus einen Radius in Kilometern an. Das System matcht Immobilien, die innerhalb dieses Kreises liegen.
Vorteile:
Felder: umkreis_ort, umkreis_plz, umkreis_strasse, umkreis_radius
User wählt aus einer Multi-Select-Region-Hierarchie (Bundesländer → Kreise → Stadtteile). Das setzt voraus, dass deine Regionen in onOffice gepflegt sind und die Immobilien korrekt kategorisiert wurden.
Vorteile:
Feld: regionaler_zusatz (Multi-Select)
| Wann | Wahl |
|---|---|
| Allgemeines End-Kunden-Formular, alle Standorte | Umkreis |
| Lokal arbeitendes Maklerbüro mit klar definierten Bezirken | Regional-Zusatz |
| Premium-Suchprofile, Reporting-relevant | Regional-Zusatz |
| Schneller Setup ohne onOffice-Region-Pflege | Umkreis |
⚠️ Wechsel zwischen den Varianten ist nicht trivial — Suchprofile, die mit Umkreis angelegt wurden, lassen sich nicht 1:1 in Regional-Zusätze umwandeln (anderer Datentyp). Entscheide dich am besten zu Beginn für eine Variante und ziehe sie konsequent durch.
propform verknüpft Suchprofile automatisch mit der Adresse, die das Formular gerade bearbeitet oder anlegt — du brauchst keine zusätzliche Datensatz-Verbindung-Konfiguration.
Typischer Workflow:
💡 Ein Adressdatensatz kann beliebig viele Suchprofile haben. Wenn der gleiche Anfragende mehrfach Suchen anlegt, kommt jedes Mal ein neues Suchprofil dazu, alle bei der gleichen Adresse.
Für Bestätigungsmails oder Übersichts-Anzeigen gibt es propform-spezifische Makros:
| Makro | Effekt |
|---|---|
_pfGetSearchCriteriaInformation |
Gibt das gerade angelegte Suchprofil als komplette Tabelle aus (alle Werte) |
_pfGetSearchCriteriaField(<feldname>) |
Gibt einen einzelnen Wert aus — z.B. _pfGetSearchCriteriaField(objektart) |
_pfGetSearchCriteriaUUID |
Verschlüsselte UUID des Suchprofils — für sichere Cross-Form-Links |
_pfButton(<URL>;<Beschriftung>) |
Erzeugt einen formatierten Button-Link in Mails/PDFs — nimmt jede URL inkl. Makro-Aufgelöster UUIDs (z.B. ein Bearbeiten-Link auf das Suchprofil) |
Beispiel-Bestätigungsmail nach Submit:
Hallo _Vorname _Name,
vielen Dank für deine Suchanfrage. Wir haben folgendes Suchprofil angelegt:
_pfGetSearchCriteriaInformation
Wir melden uns, sobald passende Immobilien verfügbar sind.
→ Im Body wird die komplette Tabelle der Suchkriterien automatisch eingefügt.
📖 Mehr unter Makros — propform-spezifisch.
propform kann nicht nur neue Suchprofile anlegen, sondern auch bestehende lesen, bearbeiten und deaktivieren — perfekt für Self-Service-Strecken („Pflege deine Suchprofile selbst").
Sehr robuster Self-Service-Workflow für Käufer/Mieter:
0. Mit Auto-Submit (siehe Auto-Submit & Routing) — der User klickt den Link in der Mail und das Formular wird ohne UI-Interaktion abgesendet → Danke-Seite erscheint sofort._bScRek_("status:1") (siehe unten) und die Makros _pfGetSearchCriteriaUUID + _pfButton(...) für die Aktion-Buttons💡 Best Practice: Der
_pfButton-Makro übernimmt das Layout (Schaltflächen-Styling) automatisch — du musst nicht in HTML formatieren.
Wenn ein User mehrere Suchprofile hat und du in einer Mail oder Übersichts-Seite alle auflisten willst, gibt es die Suchkriterien-Schleife:
_bScRek_("status:1")
Suche: _pfGetSearchCriteriaField(objektart) in _pfGetSearchCriteriaField(ort)
Preis bis: _pfGetSearchCriteriaField(kaufpreis_bis)
Link: _pfLink("https://example.com?id=_pfGetSearchCriteriaUUID", "Suchprofil öffnen")
_eScRek_
Filter status:1: Nur aktive Suchprofile. Ohne Filter: alle (auch deaktivierte).
📖 Vollständige Syntax und Filter-Optionen unter Makros → Suchkriterien-Loop.
In manchen onOffice-Versionen gibt es ein eigenes Feld „Premium-Suchprofil" (oft prio oder Custom-Feld) — eine Markierung für besonders wichtige Käufer/Mieter, die schneller / detaillierter über neue Immobilien benachrichtigt werden sollen.
propform-Setup für Premium-Markierung:
💡 Wenn du selber kein Premium-Konzept hast, ist das nicht nötig — dann reicht der Standard-Suchprofil-Workflow.
In onOffice kannst du unter Extras → Einstellungen → Administration → Suchkriterien mehrere Templates definieren — zum Beispiel ein Template „Käufer Wohnimmobilien", eines „Mieter Gewerbe" usw.
⚠️ Falle: Die onOffice-API liest ausschließlich das Default-Template (Standard-Template). Alternative Templates werden komplett ignoriert.
Symptom: Du fügst ein neues Suchkriterien-Feld in einem alternativen Template hinzu, propform „findet" es nicht. Frust.
Lösung:
Wenn das Formular sowohl objektart als auch objekttyp schreibt, müssen die Werte kompatibel sein. Inkompatible Kombinationen (z.B. Objektart = Wohnung + Objekttyp = Mehrfamilienhaus) führen dazu, dass das Suchkriterium silent nicht angelegt wird — keine Fehlermeldung, kein Datensatz.
Tipp: Beim Aufbau des Formulars die Werte-Logik einmal testweise mit verschiedenen Kombinationen prüfen, bevor du es ausrollst.
Das Suchprofil wird immer mit einer Adresse verknüpft. Wenn dein Formular ein neues Suchprofil anlegt, aber die Adresse noch nicht existiert (Dubletten-Check schlägt fehl, neue Adresse wird angelegt), läuft die Adresse-Anlage zuerst, dann das Suchprofil.
→ Funktioniert in den meisten Fällen problemlos. Nur bei sehr exotischen Validierungsfehlern auf der Adresse kann das Suchprofil scheitern.