Felder

Felder sind die Bausteine deines Formulars. Sie können Daten lesen (aus einem geladenen onOffice-Datensatz), anzeigen (Eingabe vom Formularbesucher), und beim Absenden schreiben (in einen neuen oder bestehenden onOffice-Datensatz).

Diese Seite ist ein Überblick über alle verfügbaren Feldtypen und ihre Optionen. Im Schnellstart-Video „Formular & Felder bearbeiten" siehst du die wichtigsten Funktionen in 5 Minuten.

Inhalt

• Feld hinzufügen
• Feldtypen-Übersicht
• Feldeinstellungen — Beschriftung & Hinweise
• Feldeinstellungen — Verhalten im Formular
• Feldeinstellungen — Vorausfüllung & Werte
• Zahlenfelder & Range-Slider
• Single- & Multiselect-Felder
• Datei-Upload-Felder
• Datei-Download-Felder
• Suchkriterien-Felder & Regionaler Zusatz
• Sondertypen — Überschrift, Beschreibung, Bild, Video, Akkordeon, Trennlinie, Umbruch, Link-Button, ChatGPT
• Datensatz-Verbindung-Feld

Feld hinzufügen

Wenn du ein Formular gespeichert hast, findest du unter den Formulareinstellungen die Liste der Felder. Mit einem Klick auf „Feld hinzufügen" legst du ein neues Feld an.

Felder kannst du per Drag & Drop in der gewünschten Reihenfolge anordnen. Mit einem Klick auf das Stift-Icon öffnest du die Feldeinstellungen.

💡 Felder können mehrmals hinzugefügt werden. Wenn du zwei identische Felder (selber Feldtyp + Feldname) im Formular hast, wird beim Absenden nur das letzte verwendet.

Feldtypen-Übersicht

Beim Anlegen eines Felds wählst du zuerst den Feldtyp. Die Auswahl entscheidet, was das Feld macht und welche weiteren Optionen verfügbar sind.

onOffice-Module

Die jeweils verfügbaren Einzelfelder in jedem Modul kommen direkt aus deiner onOffice-Administration. Wenn ein Feld fehlt, prüfe in onOffice unter Extras → Einstellungen → Administration, ob das Feld dort aktiviert ist.

Sondertypen (keine onOffice-Module)

Feldeinstellungen — Beschriftung & Hinweise

Auf dem Reiter „Beschriftung" legst du fest, wie das Feld im Formular beschriftet wird:

• Beschriftung: Was als Label über/neben dem Feld steht. Wenn leer, wird der Feldname aus der onOffice-Administration übernommen. Makros aktiviert — z.B. „Hallo _Vorname, was suchst du?".
• Hinweis: Kleiner Hilfstext unter dem Feld. Makros aktiviert.
• Placeholder: Grauer Vorab-Text im Feld, verschwindet beim Tippen. Makros aktiviert.
• Tooltip: Erscheint beim Hover über das Feld (kleines „?"-Icon). Makros aktiviert.
• Datalist: Vorgeschlagene Werte (;-getrennt), die der Browser als Autovervollständigung beim Tippen zeigt.

Feldeinstellungen — Verhalten im Formular

• Pflichtfeld: Formular ist nur absendbar, wenn das Feld befüllt ist.
• Feld ausblenden: Feld ist im Formular unsichtbar, wird aber trotzdem inkl. Inhalt abgesendet. Praktisch in Kombination mit Default- oder Erzwungenen Werten.
• Feld sperren (read-only): Inhalt kann vom Besucher nicht geändert werden, ist ausgegraut. Wird trotzdem abgesendet.
• Feld deaktivieren (disabled): Wie sperren, aber wird nicht abgesendet — der Wert geht ins Nirvana.
• Feldbreite halbieren: Auf großen Bildschirmen wird das Feld nur halb so breit dargestellt — wenn zwei aufeinanderfolgende Felder beide diese Option haben, stehen sie nebeneinander.
• Browser-Autocomplete: Aktiviere für Felder wie Name/E-Mail/Telefon, damit der Browser Werte aus seinem Speicher vorschlägt.

Feldeinstellungen — Vorausfüllung & Werte

Welche Vorausfüll-Werte hat ein Feld? Es gibt vier Quellen, in dieser Priorität von schwach nach stark:

Default-Wert ← überschrieben von ← Wert aus onOffice-Datensatz ← überschrieben von ← URL-Parameter ← überschrieben von ← Erzwungener Wert

• Default-Wert: Wird angezeigt, wenn das Formular leer aufgerufen wird.
• Erlaube Vorausfüllung mit URL-Parametern (Standard: an): Aktiviert, dass das Feld via ?modul[feldname]=wert vorausgefüllt werden kann.
• Erzwungene Werte: Überschreibt alles. Außerdem ist Absenden nur möglich, wenn der Wert genau dem Erzwungenen entspricht. Mehrere Werte mit ; trennen.
• Zugelassene Werte: Eine Liste erlaubter Werte (;-getrennt). Das Formular ist nur absendbar, wenn der Feldwert einem davon entspricht. Bei Single-/Multiselect werden außerdem nur diese Optionen angezeigt.

🔑 Wichtig bei Single-/Multiselect: Du musst die internen Schlüsselbezeichnungen aus der onOffice-Administration nutzen — z.B. ind_Schl_2759, nicht den angezeigten Klartext.

Mehr Details: Vorausfüllen & Datensätze laden.

Zahlenfelder & Range-Slider

Für numerische Felder (Kaufpreis, Wohnfläche, Anzahl Zimmer etc.) gibt es zusätzliche Optionen:

• Fester Minimalwert: Untergrenze, die der Besucher nicht unterschreiten kann.
• Fester Maximalwert: Obergrenze.
• Intervall: Schrittweite — z.B. 1000 für glatte Tausender-Schritte beim Kaufpreis, 0,0001 für 4-Nachkomma-Dezimalstellen.
• Minimalwert = aktueller onOffice-Wert + Intervall: Bei Bietverfahren praktisch — der Mindestwert wird dynamisch berechnet aus dem aktuellen Wert in onOffice plus dem Intervall.
• Einheit/Währung anzeigen im Feld: Frei definierbarer Suffix wie m², €, kg etc.
• Range-Slider: Statt eines Eingabefelds wird ein Slider angezeigt — mit eigenem Mini-/Maximum.

💡 Auf dem Smartphone wird automatisch die Nummerntastatur statt der Buchstabentastatur eingeblendet. Tausendertrennzeichen (Punkt) werden automatisch eingefügt.

Single- & Multiselect-Felder

Für Auswahllisten (Objektart, Kontaktart, Vermarktungsart etc.) gibt es einige Spezial-Optionen:

Custom-Beschriftungen

Statt der Original-onOffice-Bezeichnungen kannst du eigene Labels für die Optionen vergeben — z.B. „Ja"/„Nein" statt ja/nein, oder englische Übersetzungen. Du gibst die Mappings in den Feldeinstellungen pro Schlüssel an.

💡 Use-Case Mehrsprachigkeit: Wenn du eine englische/spanische Formular-Kopie pflegst, überschreibst du hier die Schlüsselbeschriftungen pro Option (apartment → Apartamento, villa → Townhouse) — ohne die onOffice-Administration anzufassen. Mehr unter Mehrsprachige Formulare.

Zugelassene Werte einschränken

Nicht jede Option soll im Formular sichtbar sein? In den Feldeinstellungen → weitere Feldeinstellungen → „Zugelassene Werte" kannst du eine Whitelist definieren — alle anderen Optionen werden ausgeblendet.

Format: Schlüsselwerte mit Semikolon getrennt — z.B. ind_3673;ind_3675.

Schlüsselwerte finden: Im Formular Rechtsklick → Untersuchen → <select> aufklappen → die <option>-Tags zeigen data-selectable-data-value (Schlüssel) + Klartext (Beschriftung).

💡 Spezialfall Benutzerfelder: Bei Single-Select-Benutzerfeldern (z.B. „Betreuer der Immobilie") sind die Schlüssel interne User-IDs wie 23, 45. Die findest du nur über den DevTools-Inspect-Trick — onOffice zeigt sie in der Administration nicht an.

Singleselect mit Suchfunktion

Bei Feldern mit vielen Optionen (z.B. Benutzerfelder) kannst du erlauben, dass beim Klick ins Feld ein Suchfeld erscheint und der Besucher nach Werten tippen kann.

Multiselect-Modi

• Normal: Standard. Öffnet Dropdown beim Klick, zeigt Hierarchie der Optionen.
• Alternativ: Spezial-Modus für Felder mit großer Baumstruktur (z.B. „Regionaler Zusatz"). Kindwerte sind im Formular nicht direkt sichtbar — werden aber beim Speichern automatisch mit-aktiviert, wenn das Elternelement angewählt ist.
• Legacy: Altes Verhalten, alle Optionen flach auf einer Ebene.

Multi-Select-Werte ergänzen statt überschreiben

Standardmäßig überschreibt ein Multi-Select-Submit den bestehenden Wert in onOffice komplett — alle vorhandenen Tags werden ersetzt. Das ist bei bestehenden Adressen (Adress-Dubletten-Check, siehe Mehrere Datensätze verbinden) oft unerwünscht: ein Kunde, der schon „Kontaktart=Käufer" hat und ein Newsletter-Formular ausfüllt, soll nicht plötzlich nur noch „Kontaktart=Newsletter" haben.

Lösung: In den Formulareinstellungen → „Werte schreiben"-Sektion die Option „Multi-Select-Werte ergänzen / entfernen" aktivieren.

• Ergänzen: Neue Werte werden zu den bestehenden Tags addiert (statt zu ersetzen)
• Entfernen: Werte werden gezielt aus der Tag-Liste entfernt (z.B. Newsletter-Abmeldung)
• Standard (überschreiben): Greift weiterhin bei neu angelegten Adressen

💡 Unterschied zu Hidden-Field-Default: Hidden-Field mit Default-Wert wirkt nur bei NEU angelegten Datensätzen. Die Ergänzen/Entfernen-Einstellung wirkt auch bei bestehenden Datensätzen über den Dubletten-Check — also genau das, was du für Newsletter-/Tag-Workflows brauchst.

Dropdown-Verhalten

• Erst beim Tippen öffnen: Dropdown erscheint nicht beim Klick, sondern erst, wenn der Besucher zu tippen beginnt.
• Nach Auswahl schließen: Dropdown schließt sich nach einer Auswahl. Wenn aus, bleibt es offen für Mehrfachauswahl.

Hierarchie

Multiselect-Felder zeigen jetzt die Hierarchie der Optionen (Eltern/Kind). Wählst du ein Eltern-Element an, werden Kindelemente automatisch mit angehakt — und umgekehrt.

Auto-Vervollständigung zwischen Feldern

Felder können sich gegenseitig automatisch ergänzen — z.B. ein Vorname-Feld, das auf Basis von Anrede+Nachname Vorschläge generiert, oder ein Suchprofil-Beschreibungsfeld, das aus mehreren Feldern automatisch zusammengestellt wird.

Setup: Feldeinstellungen → Beschriftung → Multi-Select „Auto-Vervollständigung" → andere Feldnamen aus dem Formular auswählen. Beim Ändern der Quell-Felder ergänzt sich der Tag mit deren Werten automatisch.

📖 Mehr unter Berechnete Felder.

⚠️ Anti-Pattern: Felder doppelt im Formular

Wenn du dasselbe Feld zweimal im Formular hinzufügst (z.B. Anrede oben und unten), gewinnt immer das spätere Feld beim Submit — auch wenn es leer ist. Das überschreibt das obere Feld mit nichts → Datenverlust.

Stattdessen:

• Wenn du eine zweite Person erfassen willst (z.B. Ehepartner): Nutze die onOffice-Standard-Felder Anrede2, Vorname2, Name2, Strasse2 usw. (oft in der onOffice-Administration unter „Stammdaten 2" zu aktivieren)
• Oder lege drei eigene Custom-Felder an (anrede_2, vorname_2, name_2)

💡 Stammdaten-2-Felder sind in vielen onOffice-Versionen standardmäßig deaktiviert — vor der Verwendung im propform-Formular in onOffice unter Extras → Einstellungen → Administration → Adressen aktivieren.

Datei-Upload-Felder

Wähle als Feldtyp „Datei hochladen" in einem onOffice-Modul (Adresse oder Immobilie). Der Besucher kann eine oder mehrere Dateien hochladen, die direkt zum onOffice-Datensatz gehen.

Grundeinstellungen

• Dokumentenmerkmal (nur Immobilie): Wähle aus deiner onOffice-Administration, welches Dokumentenmerkmal die Dateien bekommen.
• Datei-Art (nur Immobilie): Klassifikation als Foto, Aushang, Energieausweis, Grundriss etc. — wird automatisch auf den passenden internen/externen Reiter und die onOffice-Standard-Dateiart gemappt. Fallback-Default: „Dokument intern".
• Dateiname bei Ablage: Mit Makros — z.B. _Name_Vorname oder Geldwaeschedoku_Name. Bei Mehrfach-Upload werden automatisch _1, _2, _3 angehängt.
• Dateibeschreibung & Freitext (nur Immobilie, erste Datei): Werden in der onOffice-Datei-Maske als Beschreibung und Freitext gespeichert.
• Reiter intern/extern (nur Immobilie): Standardmäßig in „extern" (für Veröffentlichung), wahlweise „intern" (nur sichtbar für Mitarbeiter).
• Wasserzeichen anwenden: Optional ein Wasserzeichen über die Datei legen — funktioniert nur bei JPEG-Dateien.
• Ablage-Position: Position innerhalb des onOffice-Datei-Reiters.

💡 Adresse vs. Immobilie: Datei-Upload-Felder im Modul Adresse haben weniger Optionen (Dateiname + Freitext) als im Modul Immobilie (alles oben). Das ist eine onOffice-API-Vorgabe.

⚠️ Dokumentenmerkmal + Multi-Upload sind inkompatibel

Wenn ein Datei-Upload-Feld ein Dokumentenmerkmal zugeordnet hat, wird Multi-Upload automatisch auf eine Datei beschränkt — onOffice-API-Regel: 1 Merkmal = 1 Datei.

Workarounds:

• Mehrere Felder anlegen (z.B. „Ausweis Vorderseite" + „Ausweis Rückseite") jeweils mit eigenem Merkmal
• ZIP-/PDF-Bündelung aktivieren (siehe nächster Abschnitt) — alle hochgeladenen Dateien werden zu einer einzigen, die das Merkmal bekommt
• Datei-Feld ohne Merkmal verwenden — dann sind beliebig viele Uploads möglich, aber ohne Klassifikation

Apple-Browser-Quirk: Auf iPhone werden deaktivierte Single-Select-Optionen nicht versteckt, sondern ausgegraut angezeigt (HTML-Standard). Wenn du das vermeiden willst: nutze „Zugelassene Werte" (Whitelist) statt einzelne Optionen zu deaktivieren — die nicht-zugelassenen Optionen werden dann komplett aus dem Dropdown entfernt.

Mehrere Dateien zusammenfassen

Sehr praktisch für viele Fotos oder mehrere PDF-Seiten:

• ZIP-Bundling: Alle hochgeladenen Dateien werden in einer ZIP-Datei zusammengefasst. Optional „nur bei mehreren Dateien" — eine einzelne wird normal hochgeladen.
• PDF-Bundling: Mehrere Bilder oder PDF-Dateien werden zu einer PDF zusammengeführt.
• Dateien umbenennen vor Bundling: Die Dateinamen innerhalb der ZIP/PDF folgen einer Vorlage (Makros aktiviert).

Hybrid: Upload oder Download

In den Feldeinstellungen kannst du ein Datei-Feld auch als Download-Feld (für bereits vorhandene Dateien aus onOffice) oder als Hybrid (Upload + Download) konfigurieren.

Unterschriften-Pad

In den Datei-Feld-Einstellungen den Haken „Unterschriften-Feld" setzen. Statt des Standard-Datei-Pickers wird im Formular ein digitales Pad angezeigt — der Besucher zeichnet die Unterschrift mit Maus oder Finger.

• Die Unterschrift wird als PNG im onOffice-Datei-Feld gespeichert (nicht PDF)
• Wird wie eine hochgeladene Datei behandelt (Dokumentenmerkmal, Reiter, Wasserzeichen-Optionen verfügbar)
• Über die Makros _dateipfadAdressfeld bzw. _dateipfadObjektfeld kannst du die Unterschrift in onOffice-PDF-Vorlagen einfügen — perfekt für Mieterselbstauskunft, Notarbeauftragung, Vollmachten etc.

💡 Verwandte Option: Haken „Mailanhang für Dateien aus diesem Feld unterbinden" verhindert, dass die Unterschrifts-PNG zusätzlich an die Notification-Mail gehängt wird — sinnvoll, wenn die Unterschrift schon im PDF-Exposé erscheint und nicht doppelt mitgeschickt werden soll.

📺 Siehe Video: 9. Unterschrift-Feld zum Formular hinzufügen

📎 HEIC-Bilder vom iPhone werden automatisch in JPEG konvertiert. 📎 Datei-Größenlimit: 128 MB pro Einzeldatei (serverseitiges nginx-Limit). Bei größeren Einzeldateien bekommt der User einen Server-Fehler vor dem eigentlichen Upload.

Datei-Download-Felder

Mit Download-Feldern stellst du bereits in onOffice gespeicherte Dateien für Formularbesucher zum Download bereit. Praktisch für digitale Daten-/Download-Räume.

📺 Siehe Video: 12. Dateien herunterladen

Auswahlkriterien (welche Datei wird heruntergeladen?)

Du wählst aus diversen Selektoren:

• Nach Dokumentenmerkmal: Bestimmtes Merkmal exakt
• Dokumentenmerkmal enthält Zeichenkette: Z.B. alle Dateien mit „Expose" im Merkmal
• Letzte Datei mit Datei-Typ X
• Letzte Datei mit Name enthält X
• Letzte Datei mit Titel enthält X
• Alle Dateien mit Datei-Typ X / Name enthält X / Titel enthält X
• Externe URL (statisch hinterlegt)
• PDF aus onOffice-Vorlage erstellen (Exposé / Brief / Formular)

Weitere Optionen

• Datei umbenennen beim Download: Macros aktiviert — z.B. Expose_Name_Vorname.pdf
• Feld ausblenden, wenn keine Datei: Wenn der Selektor keine passende Datei findet, wird das Feld nicht angezeigt.
• Aktivität schreiben beim Download: Wer hat wann was heruntergeladen → Aktivitätsprotokoll in onOffice.

Suchkriterien-Felder & Regionaler Zusatz

Felder im Suchkriterien-Modul müssen in der onOffice-Administration explizit als Suchkriterien-Feld definiert sein, sonst werden sie propform nicht angeboten.

Range-Felder (von/bis)

Felder wie „Wohnfläche", „Kaufpreis", „Zimmeranzahl" haben in Suchkriterien einen Von- und einen Bis-Wert. Du kannst:

• Custom-Labels: Statt „von" / „bis" eigene Bezeichnungen vergeben (z.B. „mind." / „max.").
• Separate URL-Parameter: Mit doppeltem Unterstrich — ?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80

Spezialfall: Regionaler Zusatz

Das Multiselect-Feld „Regionaler Zusatz" hat oft eine sehr umfangreiche Baumstruktur (PLZ, Stadtteile, Regionen). Im Modus „Alternativ" werden die Kindelemente nicht direkt im Formular angezeigt, sondern automatisch mit-aktiviert, wenn das Elternelement angewählt wird. So bleibt das Formular schnell und übersichtlich.

Sondertypen

Überschrift

Großer Text als Abschnitts-Überschrift. Makros aktiviert — z.B. „Anfrage zu _objektart in _ort".

Beschreibung

Längerer Erklärungstext, üblicherweise zwischen Feldern. Makros aktiviert. Innerhalb von Beschreibungen kannst du propform-Makros wie _pfButton(...) oder _pfLink(...) nutzen, um Buttons und Links zu erzeugen — siehe propform-Makros.

💡 In Beschreibungs-Feldern kannst du auch iFrames einbinden — z.B. einen Timum-Termin-Buchungs-iFrame. Praktisch, um externe Funktionen direkt ins Formular zu integrieren.

HTML in Beschreibungs-Feldern

Beschreibungs-Felder erlauben umfangreiches HTML — gefiltert über HTMLPurifier (XSS-sicher, aber großzügig konfiguriert):

• Text-Formatierung: <strong>, <b>, <em>, <i>, <u>, <small>, <mark>, <sub>, <sup>, <s>, <ins>, <del>, <br>, <hr>, <p>, <h1>–<h6>
• Listen: <ul>, <ol> mit <li>
• Tabellen: <table>, <thead>, <tbody>, <tr>, <th>, <td> (mit border, cellpadding, cellspacing, colspan, rowspan)
• Links: <a href="..." target="_blank|_self|_top" class="..." type="...">
• Bilder: <img src="..." width height alt style>
• Container: <div class style>, <span class style>, <blockquote>, <cite>
• HTML5-Strukturelemente: <section>, <nav>, <article>, <aside>, <header>, <footer>, <address>, <figure>, <figcaption>
• Video: <video controls preload poster> mit <source src type>
• iFrames (HTTPS-only, z.B. für Timum-Termin-Buchung, YouTube etc.) — <iframe src width height title allow allowfullscreen frameborder>
• CSS-style-Attribute: großzügig zugelassen (inkl. !important, Vendor-Prefixes, proprietäre Properties) — du kannst Farben, Größen, Margins, Borders, Backgrounds, Flexbox/Grid, Transformationen etc. setzen

🔒 Sicherheit: <script>-Tags und Event-Handler (onclick=, onload= etc.) sind blockiert (XSS-Schutz). iFrames werden nur über HTTPS zugelassen. Du kannst also keinen beliebigen JavaScript-Code einschleusen.

Makro-Auflösung in Beschreibungs-Feldern: voll aktiv — du kannst _calculate(IF(...)) für conditional Inhalte verwenden, Felder aus dem Datensatz dynamisch einbetten, oder _pfGetSearchCriteriaInformation für Suchprofil-Tabellen einsetzen.

Umbruch

Trennt das Formular in Multi-Step-Schritte. Pro Umbruch-Feld:

• GTM-Step-Name (für Google Tag Manager)

Trennlinie

Einfache visuelle Linie. Kein Inhalt, nur zur Struktur.

Link-Button

Stylischer Button, der auf eine externe URL verlinkt. Du kannst die URL um aktuell geladene IDs/UUIDs ergänzen — z.B. „Springe zum Folgeformular mit den frisch angelegten Datensätzen". Optionen:

• Estate-ID/-UUID anhängen (mit Typ)
• Adress-ID/-UUID anhängen (mit Typ + Kontaktart)
• Suchkriterium-, Aktivitäts-, Aufgaben-, Termin-, Projekt-ID anhängen
• In neuem Tab öffnen

Bild

Eingebettetes Bild über externe URL.

Video

Eingebettetes YouTube- oder Vimeo-Video. Bei Vimeo lässt sich auch der Privacy-Hash-Parameter angeben.

Akkordeon (Collapsible Section)

Aufklappbarer Bereich. Inhalt sind beliebige andere Felder. Optionen:

• Überschrift (immer sichtbar)
• Status: Standardmäßig zugeklappt oder aufgeklappt

ChatGPT-Feld

Spezialfeld für KI-Textgenerierung — der Besucher gibt Daten ein, ChatGPT erzeugt den Text und schreibt ihn in ein onOffice-Feld. Konfiguriert wird das in den Formulareinstellungen unter „ChatGPT-Textgenerierung".

Datensatz-Verbindung-Feld

Wenn dein Formular gleichzeitig eine Adresse und eine Immobilie anlegt oder bearbeitet, brauchst du eine Verbindung zwischen den beiden — z.B. „Eigentümer", „Käufer", „Mieter", „Interessent".

In den Formulareinstellungen kannst du eine statische Verbindung wählen. Wenn du eine dynamische Verbindung brauchst (z.B. abhängig von einem Auswahl-Feld), füge ein Datensatz-Verbindung-Feld zum Formular hinzu.

Dabei ist es egal, ob du den Feldtyp „Immobilie" oder „Adresse" wählst.

Mögliche Werte:

💡 Häufig willst du das Verbindungs-Feld mit „Erzwungener Wert" + „Feld ausblenden" kombinieren, sodass der Besucher es nicht zu sehen bekommt, aber die Verbindung trotzdem hergestellt wird.

Weiter zu Vorausfüllen & Datensätze laden 👉