Autocompletar y cargar registros

Los campos se pueden autocompletar de varias maneras, y los registros existentes de onOffice se pueden cargar en tu formulario para editarlos en lugar de crearlos de nuevo.

Contenido

• Orden y prioridad
• Valor predeterminado
• Parámetros URL
• Cargar registro con UUID
• Valores forzados
• Cargar automáticamente registros relacionados
• Filtro: ¿qué registros se pueden cargar?

---

Orden y prioridad

Si un campo se rellena previamente de varias formas, se aplica el siguiente orden, de menor a mayor prioridad:

> Default-Wert ← sobrescrito por ← Wert aus onOffice-Datensatz ← sobrescrito por ← URL-Parameter ← sobrescrito por ← Erzwungener Wert

Esto significa que los valores forzados siempre prevalecen. Los parámetros URL sobrescriben el valor de onOffice cargado. El valor de onOffice sobrescribe el valor predeterminado. Si todas las fuentes están vacías, el campo también estará vacío.

---

Valor predeterminado

En la configuración del campo puedes establecer un valor predeterminado. Si se abre el formulario en blanco (sin ningún registro cargado, sin parámetros URL), este valor aparecerá rellenado de forma predeterminada.

Ejemplos:

• Campo inmobiliario «Tipo de objeto» → Valor predeterminado haus
• Campo de selección múltiple → separa varios valores con ;, p. ej., interessent;eigentuemer

> 🔑 En los campos de selección simple/múltiple, debes utilizar las denominaciones de clave internas de la administración de onOffice, p. ej., ind_Schl_2759 en lugar de «Casa».

---

Parámetros de URL

Con los parámetros de URL en la URL del formulario puedes rellenar campos al abrirlo. Requisito: en la configuración de los campos debe estar activada la opción «Permitir rellenado previo con parámetros de URL» (por defecto: activada).

Los parámetros URL se añaden a la URL con ?, y los siguientes con &:

https://propform.io/form/dein-slug?estate[objektart]=haus&estate[objekttyp]=einfamilienhaus

> 💡 El parámetro URL concreto para cada campo se encuentra en la configuración del campo, debajo de la casilla «Permitir rellenado previo con parámetros URL», como un pequeño texto de ayuda.

Esquema

modul[feldname]=wert

Selección múltiple con varios valores

En los campos de selección múltiple, debes utilizar corchetes y especificar cada valor por separado:

?address[ArtDaten][]=Eigentuemer&address[ArtDaten][]=Investor

Criterios de búsqueda de rango (de/a)

Para los campos de criterios de búsqueda con valores de «de» a «a», utiliza dos guiones bajos:

?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80

Campos booleanos (casillas de verificación)

Los campos booleanos solo aceptan, a través de parámetros URL, 1 (para «activo»/«true») y 0 (para «inactivo»/«false»):

?address[opt_in]=1
?address[newsletter_einwilligung]=1

> ⚠️ Valores como ?feld=true, ?feld=WAHR, ?feld=ja no se reconocen como valores booleanos; en ese caso, el campo permanecerá vacío. Utiliza siempre el entero 1.

Cargar un registro con UUID

Si deseas editar un registro existente de onOffice, cárgalo mediante su UUID (identificador único universal) como parámetro de URL. Los UUID no se pueden adivinar: nadie puede abrir otro registro manipulando la URL.

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

Requisitos previos

1. En la administración de onOffice: activa los campos uuid en el módulo Direcciones Y uuid en el módulo Inmuebles
2. En la configuración de formularios: marca la casilla «Rellenar previamente con UUID»

Parámetros URL por módulo (¡tenga en cuenta las mayúsculas y minúsculas!)

UUID mediante macro de correo electrónico

Si envías el enlace del formulario mediante un correo electrónico de onOffice, se puede acceder a los UUID mediante las siguientes macros:

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

Por ejemplo, un enlace de edición en una plantilla de correo de onOffice:

https://propform.io/form/dein-slug?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate

UUID mediante un campo de enlace en la máscara de onOffice

También puedes crear un campo de enlace en tu máscara de direcciones o de inmuebles de onOffice e introducir la URL mediante una fórmula:

="https://propform.io/form/dein-slug?address[ID]="&[uuid]

o para inmuebles:

="https://propform.io/form/dein-slug?estate[Id]="&[uuid]

> 💡 En la configuración del formulario, en «Editar registros existentes», propform te muestra los enlaces y fórmulas completos listos para copiar.

Valores obligatorios

En la configuración de los campos puedes establecer un valor obligatorio. Este:

• Se rellena automáticamente al abrir el formulario
• Sobrescribe los valores cargados de onOffice
• Sobrescribe los parámetros de la URL
• Permite el envío solo si el valor del campo coincide exactamente con este valor

Separa varios valores con ;.

> 💡 Ejemplo de aplicación: Estás creando un formulario de «suscripción al boletín con un solo clic». Establece un valor obligatorio de aktiv en el campo del boletín y combínalo con «Ocultar campo» + «Envío automático». El visitante hace clic una vez en el enlace, el formulario se envía inmediatamente y el estado del boletín pasa a ser aktiv.

Cargar automáticamente los registros relacionados

Si cargas una propiedad mediante UUID, propform puede cargar automáticamente la dirección vinculada, por ejemplo, la del propietario.

En la configuración del formulario, encontrarás una selección para ello en «Editar registros existentes»:

> ⚠️ Solo funciona si se carga explícitamente solo una parte (dirección O BIEN inmueble) mediante UUID. Si cargas ambos mediante UUID, prevalecerán los UUID especificados explícitamente.

Filtros: ¿qué registros se pueden cargar?

Para que no se pueda editar cualquier registro con el formulario, puedes restringir en la configuración del formulario, en «Configuración de filtros»:

• Filtro de direcciones: solo se pueden cargar las direcciones que cumplan los criterios del filtro de onOffice seleccionado
• Filtro de inmuebles: lo mismo para los inmuebles

Los filtros deben crearse previamente en tu administración de onOffice (los filtros son una función estándar de onOffice).

> 💡 Caso de uso: Creas un formulario de información del inquilino que solo debe utilizarse para ofertas de alquiler activas. Crea en onOffice un filtro «Ofertas de alquiler activas» y selecciónalo en la configuración del formulario; de este modo, los inmuebles inactivos no podrán cargarse a través del enlace del formulario, incluso si alguien conoce el UUID.

📖 Más información sobre la protección mediante filtros: Filtros por formulario.

Casos extremos y notas de seguridad

Parámetros URL en la configuración del iFrame

Si integras el formulario en tu sitio web mediante un iFrame, los parámetros URL ?param=value deben incluirse en la URL del iFrame, no en la URL del sitio web principal:

<!-- ✓ Richtig: Parameter im iframe-src -->
<iframe src="https://formular.deine-domain.de/dein-formular?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate"></iframe>

<!-- ✗ Falsch: Parameter in Eltern-URL kommen NICHT im iFrame an -->
<iframe src="https://formular.deine-domain.de/dein-formular"></iframe>

Si tienes una configuración de iFrame dinámica (los parámetros deben cambiar según el registro), la lógica de tu sitio web debe generar dinámicamente los atributos src del iFrame.

Aspectos de seguridad de los valores prellenados en la URL

Los parámetros de la URL son visibles en texto plano — El usuario puede manipularlos a su antojo antes de enviar el formulario:

• ?searchcriteria[kaufpreis_bis]=500000 se puede cambiar a ?searchcriteria[kaufpreis_bis]=999999999
• ?address[Sonstige1]=info@firma.de se puede cambiar a cualquier otro correo electrónico

Consecuencias:

• No confíes en los valores de URL para campos críticos (p. ej., precios, tasas de comisión)
• Para dichos valores → utilice valores forzados (véase más arriba): estos sobrescriben los parámetros de la URL y solo se pueden configurar en un único lugar
• En caso de UUID manipulados → utilice la protección de filtro (véase más arriba) para que los usuarios no puedan acceder a otros registros

«El enlace se elimina en los proveedores de correo electrónico»

Cuando se envían parámetros de URL largos (por ejemplo, enlaces de prellenado complejos) en correos electrónicos, algunos proveedores de correo pueden marcar los enlaces como sospechosos y, por ejemplo, eliminarlos o redirigirlos automáticamente (Microsoft Defender, Google Safe Browsing).

Opciones de solución:

• Dominio propio personalizado para el envío de correo → mejor reputación
• Enviar enlaces complejos a través de una plantilla de onOffice, no directamente en el correo de propform
• Mantener SPF/DKIM/DMARC correctamente configurados

Continuar con las macros de propform 👉