🧩 Macro — propform & onOffice

Le macro sono segnaposto che vengono sostituiti con valori reali al momento dell'esecuzione — ad esempio il nome di un indirizzo caricato, l'UUID di un immobile o la data corrente.

Contenuto

• Dove è possibile utilizzare le macro?
• Macro standard di onOffice
• Macro specifiche di propform
• Cicli — Ciclo criteri di ricerca
• Cicli — Ciclo calendario
• Cicli — Ciclo indirizzi (acquirenti / proprietari)
• Pre-macro (riferimento a record collegati)
• Accesso diretto al collegamento del tipo di contatto

---

Dove è possibile utilizzare le macro?

✅

Macro standard di onOffice |

| L'elenco completo e ufficiale delle macro è disponibile nella Guida di onOffice.

> ⚠️ Attenzione alla grafia: onOffice è inconsistente nell'uso delle maiuscole e delle minuscole. Le macro degli indirizzi sono di norma in CamelCase (prima lettera maiuscola), mentre quelle immobiliari sono minuscole. Atteniti rigorosamente alla grafia ufficiale, altrimenti la macro non verrà risolta.

Macro per indirizzi (CamelCase)

Macro immobiliari (piccole)

Macro data e ora |

|

Macro di funzione (condizioni, calcoli)

> 💡 _ifEmpty con campi utente — Modello multi-ufficio: Se ogni sede/ufficio ha un proprio link di valutazione, codice telefonico o simili, crea un campo personalizzato per l'utente (ad es. Benutzerzusatz1Name) e utilizza: _ifEmpty(_OBJBetreuer_Benutzerzusatz1Name;"https://fallback-link.de";_OBJBetreuer_Benutzerzusatz1Name) — se il responsabile ha lasciato il campo vuoto, viene applicato il fallback. Più breve e leggibile rispetto a _calculate(IF([feld]=null;"a";"b")) per i semplici controlli di vuoto.

Macro utente (dipendente che esegue l'azione)

## Macro specifiche di propform

Queste macro sono disponibili solo su propform.io — non nella versione standard di onOffice. Funzionano nei moduli, nelle attività, nelle attività e nelle e-mail scritte tramite propform (modalità di risoluzione delle macro "alternativa" in onOffice).

Pulsanti e link nei campi di descrizione

Esempi:

_pfButton("Weiter zum Formular", "https://example.com", "rounded-pill", "_blank")

_pfLink("https://example.com", "Hier klicken", "_blank")

Macro dei criteri di ricerca

> 💡 Modello self-service per i profili di ricerca: le tre macro, insieme a _pfButton(...) e al ciclo _bScRek_("status:1"), formano un flusso di lavoro self-service completo: l'e-mail di riepilogo elenca tutti i profili di ricerca attivi + pulsanti con un solo clic per modificare/disattivare. Configurazione completa in Modifica/disattiva profili di ricerca.

Macro percorso file (per immagini/firme nei modelli PDF)

Parametri:

• Nome campo: nome interno onOffice del campo del file (ad es. unterschrift_kaeufer)
• Larghezza: Valore nell'unità selezionata (ad es. 400 — valore predefinito per le firme)
• Altezza: valore fisso oppure variabel per l'altezza automatica
• Unità: px o mm
• Tipo: mail o html

Esempio — Inserire la firma dell'acquirente:

_dateipfadAdressfeld(unterschrift_kaeufer;400;variabel;mail;html)

Modello multi-sig per più acquirenti/proprietari:

All'interno del ciclo di indirizzi (_buyerbrek_1_ … _buyererek_1_, vedi sotto) puoi inserire un campo file con la firma per ogni acquirente. Se non tutti gli acquirenti hanno già firmato, avvolgilo sempre con _ifEmpty(...) — altrimenti si creerà uno spazio vuoto nel PDF:

_buyerbrek_1_
_BuyerVorname _BuyerName
_ifEmpty(unterschrift_kaeufer;"";"_dateipfadAdressfeld(unterschrift_kaeufer;400;variabel;mail;html)")
_buyererek_1_

> 💡 Disponibilità dei campi file: le macro del percorso file funzionano solo se il file si trova in un campo file onOffice del record — non nella scheda generale "File". Il campo file deve essere creato nell'amministrazione di onOffice prima dell'utilizzo.

Macro attività e appuntamenti

Deep link a onOffice-enterprise

Newsletter e accordo |

| Macro | Descrizione | | |-------|--------------| | _NewsletterDOILink | Macro standard di onOffice: link di conferma per il double opt-in della newsletter. Se il campo della newsletter è impostato su 3 (DOI in sospeso) e l'utente clicca, viene impostato su 1 (confermato). Utilizzo nell'e-mail di conferma della newsletter. | | _AgreementLink(Parameter1,Parameter2,...) | Macro propform per il link all'accordo (contratto/informativa sul diritto di recesso/protezione dei dati). I parametri controllano quali contenuti vengono visualizzati quando si richiama l'accordo. Parametri possibili: URL, Vertrag, Belehrung, Musterwiderruf, Datenschutzerklärung, Beginn, Eigentum, Finanzierung, Newsletter. | | _NewsletterLink | Standard onOffice: link di iscrizione/cancellazione per la mailing list della newsletter (cliccando si apre la pagina di iscrizione/cancellazione su onOffice). |

> 💡 Suggerimento per il link all'accordo: invece di utilizzare parametri fissi nel modello di email, puoi gestire un campo personalizzato nell'immobile (ad es. agreement_link_parameter) e fornirvi dinamicamente diversi parametri tramite la formula _calculate(IF([provisionsfrei]=null;"Vertrag,Belehrung,Musterwiderruf,Datenschutzerklärung,Beginn,Eigentum,Finanzierung,Newsletter,URL";"URL")) — ad es. senza contratto/revoca per gli immobili senza provvigione. Il modello di email richiamerà quindi solo _AgreementLink(_agreement_link_parameter).

Modalità di risoluzione delle macro di indirizzo "alternativa"

Nella configurazione e-mail di propform è presente l'impostazione "Risoluzione macro di indirizzo: normale vs. alternativa":

Quando si usa "alternativo"? Sempre quando l'e-mail viene inviata a qualcuno che non è il richiedente — ad es. notifica interna alla contabilità riguardo a un nuovo indirizzo. Altrimenti nell'e-mail sarebbero presenti i dati della contabilità anziché quelli del richiedente.

---

Cicli — Ciclo dei criteri di ricerca

Con _bScRek_ e _eScRek_ è possibile scorrere tutti i criteri di ricerca di un indirizzo e generare macro per ogni singolo criterio di ricerca — analogamente ai noti cicli del registro agenti in onOffice.

Sintassi

_bScRek_("filter")
   ... beliebige Suchkriterien-Makros ...
_eScRek_

Filtro opzionale

Con l'argomento filtro puoi limitare quali criteri di ricerca vengono presi in considerazione:

_bScRek_("status:1")

→ Solo criteri di ricerca attivi (Stato = 1).

Esempio completo

_bScRek_("status:1")
Objektart: _pfGetSearchCriteriaField(objektart)
Ort: _pfGetSearchCriteriaField(ort)
Wohnfläche: _pfGetSearchCriteriaField(wohnflaeche)
Link: _pfLink("https://example.com?id=_pfGetSearchCriteriaUUID", "Suchkriterium öffnen")
_eScRek_

---

Cicli — Ciclo calendario

Con _bCalendarRek_ e _eCalendarRek_ è possibile scorrere gli appuntamenti nel periodo specificato — ad es. per visualizzare gli slot liberi in un modulo di prenotazione.

Sintassi

_bCalendarRek_("startDate:YYYY-MM-DD;endDate:YYYY-MM-DD;weitere:filter")
   ... beliebige onOffice-Termin-Makros + _pfGetCalendarUUID ...
_eCalendarRek_

Filtro di esempio

_bCalendarRek_("startDate:2026-02-25;endDate:2026-12-31;subject:like:%TERMIN-SLOT%;estate.id:_Id")

→ Tutti gli appuntamenti nel periodo il cui oggetto contiene "TERMIN-SLOT" e che sono collegati all'immobile corrente.

Approfondimenti

Puoi trovare istruzioni dettagliate con suggerimenti copia/incolla nel blog: Guida ai filtri Calendar-Loop.

---

Cicli — Ciclo indirizzi (acquirenti / proprietari)

Con le macro del ciclo indirizzi è possibile scorrere tutti gli acquirenti o i proprietari collegati all'immobile — caso d'uso tipico: un modulo di panoramica che elenca tutte le persone relative a un immobile più i pulsanti "Modifica"/"Collega altri".

Sintassi

> All'interno del ciclo si utilizzano le pre-macro _Buyer* o _Owner* (vedi sezione successiva). _1_ è un contatore interno del ciclo — da incrementare solo se hai bisogno di più cicli indipendenti di acquirenti/proprietari nello stesso campo di descrizione.

Esempio — elencare tutti gli acquirenti di un immobile

_buyerbrek_1_
_BuyerVorname _BuyerName, _BuyerStrasse, _BuyerPLZ _BuyerOrt, _BuyerEmail
_buyererek_1_

📖 Tutorial completo con modulo di panoramica + modifica ed esempi di codice: Collegare più record con un modulo

Pre-macro (riferirsi a record collegati)

Le pre-macro accedono ai record di indirizzi collegati a un immobile — tipicamente all'interno di modelli PDF, e-mail o cicli di indirizzi.

Pre-macro per gli acquirenti

Pre-macro per il proprietario

> 💡 Buyer/Owner vs. Kaeufer/Eigent: _Buyer*/_Owner* vengono utilizzati soprattutto all'interno di loop di indirizzi e nel campo di descrizione. _Kaeufer*/_Eigent* (con nomi in tedesco) sono le classiche pre-macro dei modelli PDF che onOffice riconosce direttamente. Per i modelli PDF → vedi I valori non vengono trasferiti al PDF.

Accesso diretto al collegamento del tipo di contatto

Invece di scorrere tutti gli indirizzi collegati a un immobile, puoi anche rivolgerti direttamente a un determinato tipo di contatto, ad esempio il notaio o l'amministrazione di tale immobile:

_XAPKontaktart#NAME#FELD

> 💡 Trovare il valore chiave: puoi trovare il nome esatto del tipo di contatto in onOffice in Strumenti → Impostazioni → Amministrazione → Indirizzi → campo "Tipo di contatto" → il valore chiave è indicato accanto alla rispettiva opzione (spesso indXXXX).

Precaricamento dell'UUID senza campo nel modulo

Anche se un modulo non contiene campi relativi all'indirizzo o all'immobile, puoi "fornire" un record tramite parametri URL — l'attività creata dopo l'invio sarà quindi collegata a questo record.

https://formular.deine-domain.de/dokumenten-upload?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate

Caso d'uso: Un modulo di caricamento documenti per un inquilino (indirizzo) che deve però mantenere il riferimento all'immobile — il file caricato e l'attività saranno quindi collegati a entrambi i record, anche se nel modulo stesso sono presenti solo campi per il caricamento dei file.

> 💡 Funziona anche per le chiamate _AgreementLink e in tutti i punti in cui propform si aspetta parametri UUID.

Vai a Emoji e simboli per onOffice 👉