Vorausfüllung per UUID funktioniert nicht

Du verschickst einen Formularlink mit ?address[ID]=... oder ?estate[Id]=... — aber das Formular wird leer geöffnet, statt den Datensatz zu laden. Hier die häufigsten Ursachen.

1. Feld `uuid` in onOffice nicht aktiviert

In der onOffice-Administration muss das Feld uuid aktiviert sein:

Modul Adressen: unter Stammdaten
Modul Immobilien: unter Technische Angaben

Ohne aktiviertes uuid-Feld kann onOffice die UUID nicht ausliefern und propform nicht damit suchen.

2. „Vorausfüllung mit UUIDs" in den Formulareinstellungen aus

Selbst wenn die UUID-Felder in onOffice aktiv sind, musst du in den Formulareinstellungen unter „Bestehende Datensätze bearbeiten" den Haken bei „Vorausfüllung mit UUIDs" setzen.

Wenn der Haken aus ist, lehnt propform den UUID-Parameter ab und das Formular wird leer geöffnet.

3. Falscher URL-Parameter-Name

Die ID-Parameter unterscheiden sich pro Modul in Groß- und Kleinschreibung:

Modul	Korrekt	Falsch
Adresse	`address[ID]`	`address[Id]`, `address[id]`
Immobilie	`estate[Id]`	`estate[ID]`, `estate[id]`
Aktivität	`agentsLog[id]`	`agentslog[id]`, `agentsLog[Id]`
Aufgabe	`task[id]`	`task[ID]`
Termin	`calendar[id]`	`calendar[ID]`
Suchkriterium	`searchcriteria[id]`	`searchcriteria[ID]`

📖 Komplette URL-Parameter-Übersicht: URL-Parameter

4. API-Benutzer hat keine Leserechte auf den Datensatz

Der propform-API-Benutzer muss den Datensatz lesen dürfen. Häufige Blocker:

Datensatzrechte: Auf der Adresse oder Immobilie sind Leserechte eingeschränkt
Privat-Haken: Die Adresse hat den „Privat"-Haken gesetzt — nur der setzende Benutzer kann sie sehen
Gruppen-Modul: Der API-Benutzer ist keiner Gruppe zugeordnet

📖 Detaillierte Anleitung: Mein Formular schreibt keine Daten in onOffice

5. UUID falsch eingesetzt im onOffice-Makro

Wenn du den Link in einer onOffice-E-Mail-Vorlage mit Makros baust:

✅ Korrekt: ?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate
❌ Falsch: ?address[ID]=_address.Uuid (existiert nicht)
❌ Falsch: ?address[ID]=_AdrUUID (existiert nicht)

Die richtigen Makros:

_Uuidaddress — UUID der verknüpften Adresse
_Uuidestate — UUID der verknüpften Immobilie

6. Datensatz wurde mittlerweile gelöscht

Wenn der Datensatz, dessen UUID im Link steht, in onOffice bereits gelöscht ist, kann propform ihn nicht mehr laden. Das Formular öffnet sich dann leer.

Test-Checkliste

Wenn nichts funktioniert, prüfe in dieser Reihenfolge:

In onOffice: Datensatz manuell aufrufen — existiert er noch?
In onOffice: Feld uuid ist aktiviert? (Stammdaten bei Adressen, Technische Angaben bei Immobilien)
In propform: Formulareinstellungen → „Vorausfüllung mit UUIDs" angehakt?
Im URL-Parameter: Schreibweise korrekt? (Groß-/Kleinschreibung beachten)
API-Benutzer: Hat Leserechte auf den Datensatz?

Wenn nichts hilft

Schreib uns mit folgenden Infos an hello@propform.io:

Den kompletten Formular-Link mit URL-Parametern (UUID darfst du anonymisieren)
Datum & Uhrzeit des Aufrufs
Welcher Datensatz hätte geladen werden sollen?

propform.ioHilfe