🧩 Makros — propform & onOffice

Makros sind Platzhalter, die zur Laufzeit durch echte Werte ersetzt werden — z.B. den Vornamen einer geladenen Adresse, die UUID einer Immobilie oder das aktuelle Datum.

Inhalt

• Wo dürfen Makros genutzt werden?
• Standard-onOffice-Makros
• propform-spezifische Makros
• Schleifen — Suchkriterien-Loop
• Schleifen — Kalender-Loop
• Schleifen — Adress-Loop (Käufer / Eigentümer)
• Pre-Makros (verknüpfte Datensätze ansprechen)
• Direkter Zugriff auf Kontaktart-Verknüpfung

Wo dürfen Makros genutzt werden?

Standard-onOffice-Makros

Die komplette offizielle Makro-Liste findest du in der onOffice-Hilfe.

⚠️ Achtung Schreibweise: onOffice ist inkonsistent in der Groß-/Kleinschreibung. Adress-Makros sind in der Regel CamelCase (großer erster Buchstabe), Immobilien-Makros sind klein. Halte dich genau an die offizielle Schreibweise — sonst wird das Makro nicht aufgelöst.

Adress-Makros (CamelCase)

Immobilien-Makros (klein)

Datums- & Zeit-Makros

Funktions-Makros (Bedingungen, Berechnungen)

💡 _ifEmpty mit Benutzer-Feldern — Multi-Büro-Pattern: Wenn jeder Standort/jedes Büro einen eigenen Bewertungs-Link, Telefon-Code o.ä. hat, leg ein Custom-Feld am Benutzer an (z.B. Benutzerzusatz1Name) und nutze: _ifEmpty(_OBJBetreuer_Benutzerzusatz1Name;"https://fallback-link.de";_OBJBetreuer_Benutzerzusatz1Name) — falls der Betreuer das Feld leer hat, greift der Fallback. Kürzer und lesbarer als _calculate(IF([feld]=null;"a";"b")) für reine Empty-Checks.

Benutzer-Makros (Mitarbeiter, der die Aktion ausführt)

propform-spezifische Makros

Diese Makros gibt es nur in propform.io — nicht im normalen onOffice. Sie funktionieren in Formularen sowie in Aktivitäten, Aufgaben und E-Mails, die über propform geschrieben werden (Makro-Auflösungs-Modus „alternativ" in onOffice).

Buttons & Links in Beschreibungs-Feldern

Beispiele:

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

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

Suchkriterien-Makros

💡 Self-Service-Pattern für Suchprofile: Die drei Makros zusammen mit _pfButton(...) und der Schleife _bScRek_("status:1") ergeben einen kompletten Self-Service-Workflow: Übersichts-Mail listet alle aktiven Suchprofile + 1-Klick-Buttons zum Bearbeiten/Deaktivieren. Komplettes Setup unter Suchprofile bearbeiten / deaktivieren.

Datei-Pfad-Makros (für Bilder/Unterschriften in PDF-Vorlagen)

Parameter:

• Feldname: interner onOffice-Feldname des Datei-Felds (z.B. unterschrift_kaeufer)
• Breite: Wert in der gewählten Einheit (z.B. 400 — Standardwert für Unterschriften)
• Höhe: entweder fester Wert oder variabel für Auto-Höhe
• Einheit: px oder mm
• Typ: mail oder html

Beispiel — Käufer-Unterschrift einbinden:

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

Multi-Sig-Pattern für mehrere Käufer/Eigentümer:

Innerhalb der Adress-Loop-Schleife (_buyerbrek_1_ … _buyererek_1_, siehe unten) kannst du pro Käufer ein eigenes Datei-Feld mit Unterschrift einbinden. Wenn nicht alle Käufer schon unterschrieben haben, immer mit _ifEmpty(...) wrappen — sonst entsteht eine Lücke im PDF:

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

💡 Datei-Felder-Verfügbarkeit: Datei-Pfad-Makros funktionieren nur, wenn die Datei in einem onOffice-Datei-Feld des Datensatzes liegt — nicht im allgemeinen Reiter „Dateien". Das Datei-Feld muss vor der Verwendung in der onOffice-Administration angelegt sein.

Aktivitäts- & Termin-Makros

Deep-Links zu onOffice-enterprise

Newsletter & Agreement

💡 Agreement-Link-Tipp: Statt fester Parameter im Mail-Template kannst du ein Custom-Feld in der Immobilie pflegen (z.B. agreement_link_parameter) und dort per Formel _calculate(IF([provisionsfrei]=null;"Vertrag,Belehrung,Musterwiderruf,Datenschutzerklärung,Beginn,Eigentum,Finanzierung,Newsletter,URL";"URL")) dynamisch unterschiedliche Parameter liefern — z.B. ohne Vertrag/Widerruf bei provisionsfreien Objekten. Die Mail-Vorlage ruft dann nur _AgreementLink(_agreement_link_parameter) auf.

Adress-Makro-Auflösungs-Modus „alternativ"

In der propform-E-Mail-Konfiguration gibt es die Einstellung „Adress-Makro-Auflösung: normal vs. alternativ":

Wann „alternativ"? Immer wenn die Mail an jemanden geht, der nicht der Anfragende ist — z.B. interne Notification an Buchhaltung über eine neue Adresse. Sonst stehen Buchhaltungs-Daten in der Mail statt der Anfragenden-Daten.

Schleifen — Suchkriterien-Loop

Mit _bScRek_ und _eScRek_ lassen sich alle Suchkriterien einer Adresse durchlaufen und für jedes einzelne Suchkriterium Makros ausgeben — analog zu den bekannten Maklerbuch-Schleifen in onOffice.

Syntax

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

Optionaler Filter

Mit dem Filter-Argument schränkst du ein, welche Suchkriterien berücksichtigt werden:

_bScRek_("status:1")

→ Nur aktive Suchkriterien (Status = 1).

Vollständiges Beispiel

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

Schleifen — Kalender-Loop

Mit _bCalendarRek_ und _eCalendarRek_ lassen sich Termine im angegebenen Zeitraum durchlaufen — z.B. um freie Slots in einem Buchungs-Formular auszugeben.

Syntax

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

Beispiel-Filter

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

→ Alle Termine im Zeitraum, deren Betreff „TERMIN-SLOT" enthält und die mit der aktuellen Immobilie verknüpft sind.

Tiefer einsteigen

Eine ausführliche Anleitung mit Copy/Paste-Prompts findest du im Blog: Calendar-Loop Filter Guide.

Schleifen — Adress-Loop (Käufer / Eigentümer)

Mit den Adress-Schleifen-Makros lassen sich alle mit der Immobilie verknüpften Käufer oder Eigentümer durchlaufen — typischer Anwendungsfall: ein Übersichts-Formular, das alle Personen einer Immobilie auflistet plus „Bearbeiten"-/„Weiteren verbinden"-Buttons.

Syntax

Innerhalb der Schleife verwendest du die Pre-Makros _Buyer* bzw. _Owner* (siehe nächste Sektion). Die _1_ ist ein interner Schleifen-Zähler — nur erhöhen, wenn du mehrere unabhängige Käufer-/Eigentümer-Schleifen im selben Beschreibungs-Feld brauchst.

Beispiel — alle Käufer einer Immobilie auflisten

_buyerbrek_1_
_BuyerVorname _BuyerName, _BuyerStrasse, _BuyerPLZ _BuyerOrt, _BuyerEmail
_buyererek_1_

📖 Vollständiges Tutorial mit Übersichts- + Bearbeitungs-Formular und Code-Beispielen: Mehrere Datensätze mit einem Formular verbinden

Pre-Makros (verknüpfte Datensätze ansprechen)

Pre-Makros greifen auf Adressdatensätze zu, die mit einer Immobilie verknüpft sind — typischerweise innerhalb von PDF-Vorlagen, E-Mails oder Adress-Schleifen.

Pre-Makros für Käufer

Pre-Makros für Eigentümer

💡 Buyer/Owner vs. Kaeufer/Eigent: _Buyer*/_Owner* werden vor allem innerhalb von Adress-Loops und im Beschreibungs-Feld verwendet. _Kaeufer*/_Eigent* (mit deutschen Namen) sind die klassischen Pre-Makros aus PDF-Vorlagen, die onOffice direkt versteht. Für PDF-Vorlagen → siehe Werte werden nicht ans PDF übergeben.

Direkter Zugriff auf Kontaktart-Verknüpfung

Statt alle verknüpften Adressen einer Immobilie zu durchlaufen, kannst du auch eine bestimmte Kontaktart direkt ansprechen — z.B. den Notar oder die Verwaltung dieser Immobilie:

_XAPKontaktart#NAME#FELD

💡 Schlüsselwert finden: Den exakten Namen der Kontaktart bekommst du in onOffice unter Extras → Einstellungen → Administration → Adressen → Feld „Kontaktart" → bei der jeweiligen Option steht der Schlüsselwert dabei (oft indXXXX).

UUID-Vorausladen ohne Feld im Formular

Auch wenn ein Formular keine Adress- oder Immobilien-Felder enthält, kannst du via URL-Parameter einen Datensatz „mitliefern" — die nach Submit geschriebene Aktivität ist dann mit diesem Datensatz verknüpft.

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

Use-Case: Ein Dokumenten-Upload-Formular für einen Mieter (Adresse), das aber Immobilien-Bezug behalten soll — die hochgeladene Datei und die Aktivität sind dann mit beiden Datensätzen verknüpft, auch wenn im Formular selbst nur Datei-Upload-Felder sind.

💡 Funktioniert auch für _AgreementLink-Aufrufe und alle Stellen, an denen propform UUID-Parameter erwartet.

Weiter zu Emojis & Symbole für onOffice 👉