Felder vorausfüllen

ℹ️ Hinweis: Die Screenshots auf dieser Seite zeigen noch die vorherige propform-Oberfläche. Alle beschriebenen Funktionen und Einstellungen gelten unverändert — die Optik wurde mit dem neuen Editor modernisiert.

Um ein Formular mit Werten vorauszufüllen, stehen dir mehrere Optionen zur Verfügung:

• Default-Wert
• URL-Parameter
• onOffice-Datensätze mit UUID in das Formular laden
• Erzwungene Werte

Die Vorausfüllung eines Formulars folgt dabei folgender Logik:

Default-Wert wird überschrieben von Wert aus onOffice-Datensatz wird überschrieben von URL-Parameter wird überschrieben von Erzwungenem Wert

Default-Wert

In den Feldeinstellungen kannst du für ein Feld einen Default-Wert hinterlegen. Wird das Formular leer aufgerufen, ist dieser Wert dann vorausgefüllt. Mehrere Werte für Multiselectfelder trennst du mit einem ";".

Lädt das Formular einen onOffice-Datensatz, gewinnt normalerweise dessen Wert – auch wenn das Feld dort leer ist. Bei Zahlenfeldern kannst du mit „Default-Wert auch verwenden, wenn der geladene Datensatz hier leer ist“ festlegen, dass der Default-Wert dann trotzdem erscheint; eine 0 im Datensatz zählt dabei als leer.

In dem Beispiel oben für das Immobilienfeld Objektart, ist der Wert "haus" vorausgefüllt.

URL-Parameter

Wenn in den Feldeinstellungen der Haken "Erlaube Vorausfüllung mit URL-Parametern" gesetzt ist (standardmäßig ist dieser gesetzt), kannst du über einen URL-Parameter, der an den Formularlink angehängt wird, das Feld vorausfüllen.

URL-Parameter werden mit einem "?" getrennt vom Formularlink an den Formularlink angehangen. Weitere URL-Parameter werden mit dem "&"-Zeichen angehangen. Zum Beispiel: https://propform.io/form/FoRmUlArSlUg ? estate[objektart] = haus & estate[objekttyp] = einfamilienhaus

Der zu verwendende URL-Parameter für das Feld steht unter dem Haken in dem kleinen Hinweistext.

URL-Parameter folgen dabei folgender Logik: modul [feldname]

Folgende Module gibt es:

• estate = Immobilie
• address = Adresse
• agentsLog = Aktivität
• task = Aufgabe
• calendar = Termin
• project = Projekt

Möchtest du mehrere Werte für Multiselectfeld vorausfüllen mit URL-Parametern, musste du jeden Wert einzeln als URL-Parameter hinzufügen. Außerdem ist eine weitere öffnende und schließende Klammer nötig.

Ein Beispiel anhand des Addressfelds "Kontaktherkunft" (dieses heißt in der onOffice-Administration "ArtDaten"): Formularlink ? address[ArtDaten][] = Eigentümer & address[ArtDaten][] = Investor

onOffice-Datensätze mit UUID in das Formular laden

Wenn du einen bestehenden onOffice-Datensatz mit einem Formular abändern willst, lädst du ihn über seine UUID (universelle eindeutige Kennung) in das Formular. UUIDs lassen sich nicht erraten — niemand kann durch URL-Manipulation einen anderen Datensatz öffnen.

Aktiviere in der onOffice-Administration die Felder "uuid" im Modul Adressen und "uuid" im Modul Immobilien.

Danach aktivierst du in den Formulareinstellungen den Haken "Vorausfüllung mit UUIDs":

Den Datensatz lädst du in das Formular, indem du die UUID als URL-Parameter mitgibst:

https://propform.io/form/FoRmUlArSlUg ? address[ID] = f4059f75-8155-4869-b244-d036c3babfd1

Die URL-Parameter unterscheiden sich leicht in Groß- und Kleinschreibung, bedingt durch die Bezeichnung in der onOffice-Administration:

• Adresse: address[ID] (großes I, großes D)
• Immobilie: estate[Id] (großes I, kleines d)

Wenn du einen Formularlink per E-Mail verschickst, ist die UUID per Makro "_Uuidaddress" bzw. "_Uuidestate" zugänglich.

Erzwungene Werte

In den Feldeinstellungen kannst du für ein Feld "Erzwungene Werte" hinterlegen. Wird das Formular leer aufgerufen, ist dieser Wert dann vorausgefüllt, außerdem wird dieser Wert nicht von URL-Parametern oder Werten aus einem onOffice-Datensatz überschrieben. Beim Absenden wird der Wert nicht geprüft – soll er fest bleiben, schalte zusätzlich „Feld sperren“ oder „Feld ausblenden“ ein. Mit {leer} als erzwungenem Wert wird das Feld in onOffice geleert – bei jedem Feldtyp außer Benutzerfeldern (z.B. Betreuer, die bleiben unverändert), auch beim automatischen Absenden. Eine 0 ist dagegen ein echter Wert (z.B. Newsletter = Nein). Mehrere Werte für Multiselectfelder trennst du mit einem ";".