I profili di ricerca costituiscono un modulo a sé stante in onOffice: un acquirente/affittuario descrive l'immobile che desidera (regione, tipologia dell'immobile, fascia di prezzo, superficie abitabile ecc.), e onOffice effettua in seguito abbinamenti automatici con gli immobili corrispondenti. propform può creare profili di ricerca completi tramite modulo — inclusi campi multi-regione, campi intervallo e collegamento automatico con l'indirizzo.
_pfGetSearchCriteria*)In onOffice un profilo di ricerca è un record autonomo — collegato a un indirizzo, ma non un campo dell'indirizzo. Un indirizzo può avere più profili di ricerca (ad es. "Cerco appartamento di proprietà a Berlino" + "Cerco condominio da investimento in tutta la Germania").
Conseguenze per propform:
Configurazione:
Campi tipici dei criteri di ricerca:
objektart (Appartamento / Casa / Terreno / Locale commerciale)vermarktungsart (Acquisto / Affitto / Locazione)kaufpreis (Campo intervallo — propform mostra automaticamente due campi di immissione "da" / "a")kaltmiete (Campo intervallo)wohnflaeche (campo intervallo)anzahl_zimmer (campo intervallo)regionaler_zusatz (selezione multipla regioni)> 💡 Campi intervallo: I campi sopra indicati si chiamano semplicemente kaufpreis, wohnflaeche ecc. — non kaufpreis_von / kaufpreis_bis. propform riconosce automaticamente che si tratta di un campo intervallo e mostra due campi di immissione.
> ⚠️ Importante: affinché un campo compaia nel modulo dei criteri di ricerca, deve essere definito esplicitamente come campo dei criteri di ricerca in onOffice (Strumenti → Impostazioni → Amministrazione → Modulo criteri di ricerca). In caso contrario, propform non lo visualizzerà.
I criteri di ricerca funzionano tipicamente con valori intervallo (prezzo da 200.000 a 500.000, superficie abitabile da 80 a 120 m²). Basta aggiungere il campo con il suo nome di base (ad es. kaufpreis) — propform riconosce automaticamente che si tratta di un campo intervallo e mostra due campi di immissione ("da" / "a").
> ⚠️ Il Range Slider qui non funziona: il campo speciale "Range Slider" è disponibile solo per i normali campi numerici, non per i campi intervallo dei criteri di ricerca. Per i criteri di ricerca rimangono due campi di immissione.
## Selezione multipla: regioni e tipi di immobile
Nei campi classici dei criteri di ricerca come regionaler_zusatz o objektart, l'utente spesso desidera selezionare più valori (ad es. "Berlin-Mitte E Berlin-Friedrichshain"). propform lo fa automaticamente tramite il campo a selezione multipla.
Suggerimenti per la selezione multipla nei criteri di ricerca:
In onOffice esistono due modi fondamentalmente diversi per impostare una ricerca geografica — ognuno ha i propri punti di forza:
L'utente inserisce un indirizzo di riferimento (CAP, località, via) più un raggio in chilometri. Il sistema individua gli immobili che si trovano all'interno di questo cerchio.
Vantaggi:
Campi: umkreis_ort, umkreis_plz, umkreis_strasse, umkreis_radius
L'utente seleziona da una gerarchia regionale a selezione multipla (Stati federali → Distretti → Quartieri). Ciò presuppone che le tue regioni siano gestite in onOffice e che gli immobili siano stati correttamente categorizzati.
Vantaggi:
Campo: regionaler_zusatz (selezione multipla)
| Quando | Scelta |
|---|---|
| Modulo generale per clienti finali, tutte le sedi | Raggio |
| Agenzia immobiliare che opera a livello locale con distretti chiaramente definiti | Supplemento regionale |
| Profili di ricerca premium, rilevanti per il reporting | Supplemento regionale |
| Configurazione rapida senza gestione delle regioni in onOffice | Raggio |
> ⚠️ Il passaggio da una variante all'altra non è banale — I profili di ricerca creati con il raggio non possono essere convertiti 1:1 in supplementi regionali (tipo di dati diverso). È consigliabile scegliere una variante all'inizio e utilizzarla in modo coerente.
propform collega automaticamente i profili di ricerca all'indirizzo che il modulo sta modificando o creando — non è necessaria alcuna configurazione aggiuntiva per il collegamento dei record.
Flusso di lavoro tipico:
> 💡 Un record di indirizzo può avere un numero illimitato di profili di ricerca. Se lo stesso richiedente crea più ricerche, ogni volta viene aggiunto un nuovo profilo di ricerca, tutti con lo stesso indirizzo.
Per le e-mail di conferma o le visualizzazioni di riepilogo sono disponibili macro specifiche di propform:
| Macro | Effetto |
|---|---|
_pfGetSearchCriteriaInformation |
Genera il profilo di ricerca appena creato come tabella completa (tutti i valori) |
_pfGetSearchCriteriaField(<feldname>) |
Visualizza un singolo valore — ad es. _pfGetSearchCriteriaField(objektart) |
_pfGetSearchCriteriaUUID |
UUID crittografato del profilo di ricerca — per collegamenti sicuri tra moduli |
_pfButton(<URL>;<Beschriftung>) |
Genera un collegamento a pulsante formattato in e-mail/PDF — accetta qualsiasi URL, inclusi gli UUID risolti dalle macro (ad es. un collegamento di modifica al profilo di ricerca) |
Esempio di email di conferma dopo l'invio:
Hallo _Vorname _Name,
vielen Dank für deine Suchanfrage. Wir haben folgendes Suchprofil angelegt:
_pfGetSearchCriteriaInformation
Wir melden uns, sobald passende Immobilien verfügbar sind.
→ Nel corpo del messaggio viene inserita automaticamente la tabella completa dei criteri di ricerca.
📖 Maggiori informazioni su Macro — specifiche di propform.
## Modifica / disattivazione dei profili di ricerca
propform non solo è in grado di creare nuovi profili di ricerca, ma anche di leggere, modificare e disattivare quelli esistenti — perfetto per i percorsi self-service ("Gestisci autonomamente i tuoi profili di ricerca").
Flusso di lavoro self-service molto solido per acquirenti/locatari:
0. Con Auto-Submit (vedi Auto-Submit & Routing) — l'utente clicca sul link nell'e-mail e il modulo viene inviato senza interazione con l'interfaccia utente → La pagina di ringraziamento appare immediatamente._bScRek_("status:1") (vedi sotto) e le macro _pfGetSearchCriteriaUUID + _pfButton(...) per i pulsanti di azione> 💡 Best practice: la macro _pfButton gestisce automaticamente il layout (stile dei pulsanti) — non è necessario formattare in HTML.
Se un utente ha più profili di ricerca e vuoi elencarli tutti in un'e-mail o in una pagina di riepilogo, puoi utilizzare il ciclo dei criteri di ricerca:
_bScRek_("status:1")
Suche: _pfGetSearchCriteriaField(objektart) in _pfGetSearchCriteriaField(ort)
Preis bis: _pfGetSearchCriteriaField(kaufpreis_bis)
Link: _pfLink("https://example.com?id=_pfGetSearchCriteriaUUID", "Suchprofil öffnen")
_eScRek_
Filtro status:1: Solo profili di ricerca attivi. Senza filtro: tutti (anche quelli disattivati).
📖 Sintassi completa e opzioni di filtro in Macro → Ciclo criteri di ricerca.
In alcune versioni di onOffice è presente un campo dedicato "Profilo di ricerca Premium" (spesso prio o campo personalizzato) — un contrassegno per acquirenti/locatari particolarmente importanti, che devono essere informati in modo più rapido/dettagliato sui nuovi immobili.
Configurazione propform per il contrassegno Premium:
> 💡 Se non disponi di un concetto Premium, ciò non è necessario — in tal caso è sufficiente il flusso di lavoro standard dei profili di ricerca.
In onOffice puoi definire diversi modelli in Strumenti → Impostazioni → Amministrazione → Criteri di ricerca — ad esempio un modello "Acquirenti immobili residenziali", uno "Affittuari commerciali" ecc.
> ⚠️ Insidiosa: l’API di onOffice legge esclusivamente il modello predefinito (modello standard). I modelli alternativi vengono completamente ignorati.
Sintomo: aggiungi un nuovo campo di criteri di ricerca in un modello alternativo, ma propform non lo “trova”. Frustrazione.
Soluzione:
Se il modulo scrive sia objektart che objekttyp, i valori devono essere compatibili. Combinazioni incompatibili (ad es. tipo di oggetto = Wohnung + tipo di oggetto = Mehrfamilienhaus) comportano che il criterio di ricerca non venga creato in modo silenzioso — nessun messaggio di errore, nessun record.
Suggerimento: durante la creazione del modulo, verifica la logica dei valori con diverse combinazioni a titolo di prova prima di implementarlo.
Il profilo di ricerca è sempre collegato a un indirizzo. Se il tuo modulo crea un nuovo profilo di ricerca, ma l'indirizzo non esiste ancora (il controllo dei duplicati fallisce, viene creato un nuovo indirizzo), viene eseguita prima la creazione dell'indirizzo, poi quella del profilo di ricerca.
→ Nella maggior parte dei casi funziona senza problemi. Il profilo di ricerca può fallire solo in caso di errori di convalida molto particolari sull'indirizzo.