🔗 Verknüpfungs-Feld (Datensätze verbinden)

Das Verknüpfungs-Feld zeigt im Formular die Datensätze, die in onOffice mit dem geladenen Datensatz verbunden sind — z. B. die Eigentümer einer Immobilie — und erlaubt je nach Einstellung das Hinzufügen, Neu-Anlegen, Bearbeiten und Entfernen solcher Verbindungen. Geschrieben wird grundsätzlich erst beim Absenden des Formulars.

Ein Feld steht dabei immer für genau einen Relationstyp aus Sicht des geladenen Datensatzes. Du kannst mehrere Verknüpfungs-Felder in einem Formular kombinieren (z. B. „Eigentümer" und „Mieter" untereinander).

Typische Anwendungsfälle

  • Maklervertrag: Der Kunde öffnet das Formular über seinen persönlichen Link, sieht die bereits erfassten Miteigentümer und ergänzt über das Miniformular einen weiteren Eigentümer — der beim Absenden in onOffice angelegt und mit der Immobilie verbunden wird.
  • Internes Formular: Dein Team verbindet über die Bestandssuche schnell vorhandene Adressen mit einer Immobilie (z. B. Interessenten oder Ansprechpartner) — ohne onOffice zu öffnen.
  • Datenpflege: Ein Eigentümer korrigiert über den Bearbeiten-Stift seinen Namen oder trägt seine E-Mail-Adresse nach.

Feld anlegen

  1. Öffne im Formular-Editor die Feldtyp-Palette (+ Feld hinzufügen) und wähle die Kachel „Verknüpfung" (Gruppe onOffice-Daten).
  2. Wähle in Schritt 2 den Relationstyp — die Liste ist zweigeteilt:
    • An der Immobilie (zeigt Personen): Eigentümer, Käufer, Mieter, Bewohner/Nutzer, Interessenten, Ansprechpartner (Makler/alle), Tippgeber, Angebotsempfänger.
    • An der Adresse (zeigt Immobilien bzw. Kontakte): Eigentum, gekaufte/gemietete/bewohnte Immobilien, Immobilien als Interessent, betreute Immobilien, getippte Immobilien, angebotene Immobilien — sowie Ansprechpartner der Adresse (Kontakte einer Firmen-Hauptadresse).

Voraussetzung: „An der Immobilie" braucht eine geladene Immobilie im Formular (z. B. über den Immobilien-Link oder das Vorausfüllen), „An der Adresse" eine geladene oder im Formular entstehende Adresse.

Die Schalter im Überblick

Schalter Wirkung
Bestehende Verbindungen anzeigen Zeigt die verbundenen Datensätze als Liste (Adressen: Name und Ort — bewusst ohne Kundennummer und E-Mail; Immobilien: Straße, Ort und Objektnummer).
Hinzufügen per Bestandssuche Blendet ein Suchfeld ein: Treffer aus deinem Bestand lassen sich per Klick vormerken („NEU") und werden beim Absenden verbunden. Achtung: Die Suche macht deinen Bestand (im Rahmen des Formular-Filters) für Formular-Besucher durchsuchbar — gedacht für interne Formulare.
Neuanlage über Miniformular Blendet „+ Neuen Eintrag anlegen" ein: Der Besucher füllt die von dir konfigurierten Felder aus; beim Absenden wird der Datensatz in onOffice angelegt und verbunden. Für öffentliche Formulare geeignet — es wird nichts aus dem Bestand preisgegeben.
Bearbeiten verbundener Datensätze Zeigt an jedem Eintrag einen Stift: Das Miniformular öffnet sich vorbefüllt mit den aktuellen Werten der konfigurierten Felder. Nur diese Felder werden angezeigt und geschrieben — nie der ganze Datensatz.
Entfernen bestehender Verbindungen Zeigt an jedem Eintrag ein ×. Entfernte Einträge werden bis zum Absenden nur markiert (mit Rückgängig) — erst beim Absenden wird die Verbindung in onOffice gelöst. Die Datensätze selbst bleiben erhalten.

Das Miniformular (Neuanlage & Bearbeiten)

Für Neuanlage und Bearbeiten konfigurierst du eine gemeinsame Feldliste:

  • Datenfelder des Ziel-Datensatzes (Adresse bzw. Immobilie, inklusive Individualfelder) — jedes Feld wird typgerecht gerendert (Auswahllisten, Mehrfachauswahl, Datum, Zahl …) und kann als Pflichtfeld markiert werden.
  • Layout-Elemente: Überschrift, Beschreibung (Erklärtext), Trennlinie und Aufklapper — z. B. für „Weitere Angaben (optional)".
  • Die Reihenfolge steuerst du über die Pfeile.

Pro Absendung sind bis zu 10 Neuanlagen je Feld möglich.

Dublettencheck bei der Neuanlage

Standardmäßig prüft propform vor der Neuanlage, ob der Datensatz bereits existiert — anhand der von dir gewählten Prüf-Felder (z. B. E-Mail). Bei einem Treffer wird der bestehende Datensatz verbunden statt ein neuer angelegt; der Bestand wird dabei nicht überschrieben. Das entspricht der Mechanik des Dublettenchecks in den Formulareinstellungen.

Pflichtfeld & Hinweistext

  • Pflichtfeld: Nach dem Absenden muss mindestens ein Datensatz verbunden sein — bereits bestehende Verbindungen zählen mit, neu angelegte und per Suche verknüpfte ebenfalls; entfernte nicht. Besucher sehen die übliche Pflicht-Markierung (*) und eine Meldung am Feld, solange kein Eintrag vorhanden ist. Die Prüfung läuft zusätzlich serverseitig.
  • Hinweistext: erscheint wie bei anderen Feldern unter dem Feld; Makros werden aufgelöst.

Darstellung im propform-PDF

Erstellt dein Formular ein propform-PDF, erscheint das Verknüpfungs-Feld darin als Liste: pro verbundenem bzw. neu angelegtem Datensatz ein kleiner Block mit den Feldern des Miniformulars als Label-Wert-Zeilen — beim Maklervertrag stehen so z. B. alle Eigentümer im Dokument.

  • Gezeigt wird der Stand nach der Absendung: bereits vorher verbundene Datensätze plus die in dieser Absendung angelegten/verknüpften; entfernte Verbindungen erscheinen nicht.
  • Bereits vorhandene Datensätze erscheinen nur, wenn „Bestehende Verbindungen anzeigen" am Feld aktiv ist — sonst zeigt das PDF ausschließlich, was der Besucher selbst angelegt oder verknüpft hat.
  • Welche Angaben pro Datensatz erscheinen, bestimmt die Feldliste des Miniformulars — ohne konfigurierte Miniformular-Felder gibt es nichts darzustellen.
  • Bei aktiver Dokument-Unterschrift sieht der Besucher die Liste bereits in der Dokumentansicht — er unterschreibt also genau das, was später im PDF steht.

Sicherheit

  • Nur signierte Datensätze: Verbunden, bearbeitet oder getrennt werden kann ausschließlich, was der Server selbst ausgeliefert hat (Bestandsliste bzw. Suchtreffer unter dem Formular-Filter). Manipulierte Anfragen werden still verworfen.
  • Feld-Konfiguration zählt: Welche Relation, welche Schalter und welche Miniformular-Felder gelten, entscheidet immer deine Konfiguration — nie die Anfrage des Besuchers.
  • Sparsame Anzeige: Die Verbindungsliste zeigt bewusst keine Kundennummern oder E-Mail-Adressen; die Bearbeiten-Vorbefüllung liefert nur die konfigurierten Felder aus.
  • Filter respektiert: Die Bestandssuche durchsucht nur Datensätze im Rahmen des am Formular hinterlegten Immobilien- bzw. Adressfilters.

Tipps

  • Für öffentliche Formulare (z. B. Maklervertrag): „Anzeigen" + „Neuanlage" (+ ggf. „Bearbeiten"/„Entfernen") aktivieren, die Bestandssuche aus lassen.
  • Für interne Formulare: Bestandssuche aktivieren — dein Team verbindet vorhandene Datensätze in Sekunden.
  • Der Tippgeber ist hier ein normaler Relationstyp: Ein Feld „Tippgeber" an der Immobilie zeigt die verbundenen Tippgeber-Adressen; „Getippte Immobilien" an der Adresse die Gegenrichtung.