Campos

Los campos son los componentes básicos de tu formulario. Pueden leer datos (de un registro de onOffice cargado), mostrar (la información introducida por el usuario del formulario) y, al enviarlo, escribir (en un registro de onOffice nuevo o ya existente).

Esta página ofrece una visión general de todos los tipos de campos disponibles y sus opciones. En el vídeo de inicio rápido «Editar formularios y campos» podrás ver las funciones más importantes en 5 minutos.

Contenido

• Añadir campo
• Resumen de tipos de campos
• Configuración de campos — Etiqueta y notas
• Configuración de campos — Comportamiento en el formulario
• Configuración de campos — Autocompletado y valores
• Campos numéricos y controles deslizantes de rango
• Campos de selección simple y múltiple
• Campos de carga de archivos
• Campos de descarga de archivos
• Campos de criterios de búsqueda y complemento regional
• Tipos especiales — Encabezado, Descripción, Imagen, Vídeo, Acordeón, Línea divisoria, Salto de línea, Botón de enlace, ChatGPT
• Campo de conexión de registros

Añadir campo

Una vez guardado el formulario, encontrarás la lista de campos en la configuración del formulario. Haz clic en «Añadir campo» para crear un nuevo campo.

Puedes ordenar los campos en el orden que desees mediante arrastrar y soltar. Al hacer clic en el icono del lápiz, se abren los ajustes del campo.

> 💡 Los campos se pueden añadir varias veces. Si tienes dos campos idénticos (mismo tipo de campo + nombre de campo) en el formulario, al enviarlo solo se utilizará el último.

---

Resumen de tipos de campo

Al crear un campo, primero debes seleccionar el tipo de campo. La selección determina la función del campo y las opciones adicionales disponibles.

Módulos de onOffice

> Los campos individuales disponibles en cada módulo provienen directamente de tu administración de onOffice. Si falta un campo, comprueba en onOffice, en Extras → Configuración → Administración, si el campo está activado allí.

Tipos especiales (no son módulos de onOffice)

Configuración de campos — Etiqueta e indicaciones

En la pestaña «Etiqueta» se define cómo se etiqueta el campo en el formulario:

• Etiqueta: lo que aparece como etiqueta encima o al lado del campo. Si se deja en blanco, se toma el nombre del campo de la administración de onOffice. Macros activadas — p. ej., «Hola _Vorname, ¿qué buscas?».
• Nota: Pequeño texto de ayuda debajo del campo. Macros activadas.
• Marcador de posición: Texto gris preliminar en el campo, desaparece al escribir. Macros activadas.
• Información sobre herramientas: Aparece al pasar el cursor por encima del campo (pequeño icono «?»). Macros activadas.
• Lista de datos: valores sugeridos (separados por ;) que el navegador muestra como autocompletado al escribir.

Configuración de campos — Comportamiento en el formulario

• Campo obligatorio: el formulario solo se puede enviar si el campo está rellenado.
• Ocultar campo: el campo es invisible en el formulario, pero se envía de todos modos, incluido su contenido. Resulta práctico en combinación con valores predeterminados o forzados.
• Bloquear campo (solo lectura): el visitante no puede modificar el contenido; aparece en gris. Se envía de todos modos.
• Desactivar campo (desactivado): Igual que bloquear, pero no se envía — el valor se pierde.
• Reducir a la mitad el ancho del campo: En pantallas grandes, el campo se muestra con la mitad de ancho — si dos campos consecutivos tienen ambos esta opción, se muestran uno al lado del otro.
• Autocompletado del navegador: Actívalo para campos como Nombre/Correo electrónico/Teléfono, para que el navegador sugiera valores de su memoria.

Ajustes de campo — Autocompletado y valores

¿Qué valores de autocompletado tiene un campo? Hay cuatro fuentes, en este orden de prioridad de menor a mayor:

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

• Valor predeterminado: Se muestra cuando se abre el formulario en blanco.
• Permitir autocompletado con parámetros URL (por defecto: activado): permite que el campo se autocomplete mediante ?modul[feldname]=wert.
• Valores obligatorios: anula todo. Además, solo es posible enviar el formulario si el valor coincide exactamente con el valor obligatorio. Separa varios valores con ;.
• Valores permitidos: Una lista de valores permitidos (separados por ;). El formulario solo se puede enviar si el valor del campo coincide con uno de ellos. Además, en la selección simple o múltiple solo se mostrarán estas opciones.

> 🔑 Importante para selección única/múltiple: Debes utilizar las denominaciones de clave internas de la administración de onOffice —por ejemplo, ind_Schl_2759—, no el texto sin cifrar que se muestra.

Más detalles: Rellenar previamente y cargar registros.

## Campos numéricos y controles deslizantes de rango

Para los campos numéricos (precio de compra, superficie habitable, número de habitaciones, etc.) hay opciones adicionales:

• Valor mínimo fijo: límite inferior que el visitante no puede rebasar.
• Valor máximo fijo: límite superior.
• Intervalo: Incremento — p. ej., 1000 para incrementos de mil en el precio de compra, 0,0001 para 4 decimales.
• Valor mínimo = valor actual de onOffice + intervalo: Práctico en procedimientos de licitación: el valor mínimo se calcula dinámicamente a partir del valor actual en onOffice más el intervalo.
• Mostrar unidad/moneda en el campo: Sufijo libremente definible como m², €, kg, etc.
• Control deslizante de rango: en lugar de un campo de entrada, se muestra un control deslizante, con su propio mínimo y máximo.

> 💡 En el smartphone se muestra automáticamente el teclado numérico en lugar del teclado alfabético. Los separadores de miles (punto) se insertan automáticamente.

Campos de selección única y múltiple

Para las listas de selección (tipo de objeto, tipo de contacto, tipo de comercialización, etc.) hay algunas opciones especiales:

Etiquetas personalizadas

En lugar de las denominaciones originales de onOffice, puedes asignar tus propias etiquetas a las opciones —por ejemplo, «Sí»/«No» en lugar de ja/nein, o traducciones al inglés. Indica las asignaciones en la configuración de los campos para cada clave.

> 💡 Caso de uso: multilingüismo: Si mantienes una copia del formulario en inglés/español, sobrescribe aquí las etiquetas de las claves para cada opción (apartment → Apartamento, villa → Townhouse), sin necesidad de acceder a la administración de onOffice. Más información en Formularios multilingües.

Restringir los valores permitidos

¿No quieres que todas las opciones sean visibles en el formulario? En Configuración de campos → Más opciones de configuración → «Valores permitidos» puedes definir una lista blanca; todas las demás opciones quedarán ocultas.

Formato: valores clave separados por punto y coma — p. ej., ind_3673;ind_3675.

Buscar valores clave: En el formulario, haz clic con el botón derecho → Inspeccionar → Despliega <select> → las etiquetas <option> muestran data-selectable-data-value (clave) + texto sin formato (etiqueta).

> 💡 Caso especial de los campos de usuario: En los campos de usuario de selección única (p. ej., «Responsable de la propiedad»), las claves son ID de usuario internos como 23, 45. Solo puedes encontrarlas mediante el truco de DevTools-Inspect, ya que onOffice no las muestra en la administración.

Selección única con función de búsqueda

En los campos con muchas opciones (p. ej., campos de usuario), puedes permitir que, al hacer clic en el campo, aparezca un cuadro de búsqueda y el visitante pueda escribir los valores.

Modos de selección múltiple

• Normal: Predeterminado. Abre un menú desplegable al hacer clic y muestra la jerarquía de opciones.
• Alternativo: Modo especial para campos con una estructura de árbol grande (p. ej., «Añadido regional»). Los valores secundarios no son visibles directamente en el formulario, pero se activan automáticamente al guardar si se selecciona el elemento principal.
• Legado: Comportamiento antiguo, todas las opciones en un solo nivel.

Añadir valores de selección múltiple en lugar de sobrescribirlos

Por defecto, al enviar una selección múltiple, se sobrescribe completamente el valor existente en onOffice: se sustituyen todas las etiquetas existentes. Esto suele ser indeseable en el caso de direcciones existentes (comprobación de duplicados de direcciones, véase Combinar varios registros): un cliente que ya tiene «Tipo de contacto=Comprador» y rellena un formulario de boletín informativo no debería pasar a tener de repente solo «Tipo de contacto=Boletín informativo».

Solución: En la configuración del formulario → sección «Escribir valores», active la opción «Añadir/eliminar valores de selección múltiple».

• Añadir: Los nuevos valores se añaden a las etiquetas existentes (en lugar de sustituirlas)
• Eliminar: los valores se eliminan de forma selectiva de la lista de etiquetas (p. ej., baja del boletín)
• Predeterminado (sobrescribir): sigue aplicándose a las direcciones de nueva creación

> 💡 Diferencia con el valor predeterminado del campo oculto: el campo oculto con valor predeterminado solo se aplica a los registros NUEVOS. La configuración de añadir/eliminar también se aplica a los registros existentes mediante la comprobación de duplicados, es decir, justo lo que necesitas para los flujos de trabajo de boletines informativos y etiquetas.

Comportamiento del menú desplegable

• Abrir solo al escribir: El menú desplegable no aparece al hacer clic, sino solo cuando el visitante empieza a escribir.
• Cerrar tras la selección: El menú desplegable se cierra tras una selección. Si está desactivado, permanece abierto para la selección múltiple.

Jerarquía

Los campos de selección múltiple muestran ahora la jerarquía de las opciones (padre/hijo). Si seleccionas un elemento padre, los elementos hijos se marcan automáticamente, y viceversa.

Autocompletado entre campos

Los campos pueden completarse automáticamente entre sí; por ejemplo, un campo de nombre que genere sugerencias basadas en el tratamiento y el apellido, o un campo de descripción del perfil de búsqueda que se compile automáticamente a partir de varios campos.

Configuración: Ajustes de campo → Etiqueta → Selección múltiple «Autocompletado» → selecciona otros nombres de campo del formulario. Al modificar los campos de origen, la etiqueta se completa automáticamente con sus valores.

📖 Más información en Campos calculados.

⚠️ Antipatrón: campos duplicados en el formulario

Si añades el mismo campo dos veces en el formulario (p. ej., tratamiento arriba y abajo), siempre prevalecerá el campo posterior al enviar el formulario, incluso si está vacío. Esto sobrescribe el campo superior con nada → pérdida de datos.

En su lugar:

• Si quieres registrar a una segunda persona (p. ej., cónyuge): utiliza los campos estándar de onOffice Anrede2, Vorname2, Name2, Strasse2, etc. (a menudo hay que activarlos en la administración de onOffice, en «Datos maestros 2»)
• O crea tres campos personalizados propios (anrede_2, vorname_2, name_2)

> 💡 Los campos de Datos maestros 2 están desactivados de forma predeterminada en muchas versiones de onOffice; antes de utilizarlos en el formulario de propform en onOffice, actívalos en Extras → Ajustes → Administración → Direcciones.

## Campos de carga de archivos

Selecciona como tipo de campo «Subir archivo» en un módulo de onOffice (Dirección o Inmueble). El visitante puede subir uno o varios archivos, que se guardarán directamente en el registro de onOffice.

Ajustes básicos

• Característica del documento (solo Inmueble): selecciona en la administración de onOffice qué característica de documento se asignará a los archivos.
• Tipo de archivo (solo Inmueble): Clasificación como Foto, Aushang, Energieausweis, Grundriss, etc. — se asigna automáticamente a la pestaña interna/externa correspondiente y al tipo de archivo estándar de onOffice. Valor predeterminado de reserva: «Documento interno».
• Nombre del archivo al archivarlo: con macros — p. ej., _Name_Vorname o Geldwaeschedoku_Name. En caso de carga múltiple, se añaden automáticamente _1, _2, _3.
• Descripción del archivo y texto libre (solo inmuebles, primer archivo): se guardan en la máscara de archivos de onOffice como descripción y texto libre.
• Pestaña interno/externo (solo inmueble): Por defecto en «externo» (para publicación), opcionalmente «interno» (solo visible para empleados).
• Aplicar marca de agua: Opcionalmente, superponer una marca de agua sobre el archivo; solo funciona con archivos JPEG.
• Ubicación de almacenamiento: Ubicación dentro de la pestaña de archivos de onOffice.

> 💡 Dirección frente a Inmueble: Los campos de carga de archivos en el módulo Dirección tienen menos opciones (nombre de archivo + texto libre) que en el módulo Inmueble (todo lo anterior). Se trata de una configuración predeterminada de la API de onOffice.

⚠️ La característica de documento + la carga múltiple son incompatibles

Si a un campo de carga de archivos se le ha asignado una característica de documento, la carga múltiple se limita automáticamente a un solo archivo — Regla de la API de onOffice: 1 característica = 1 archivo.

Soluciones alternativas:

• Crear varios campos (p. ej., «Anverso del documento de identidad» + «Reverso del documento de identidad»), cada uno con su propia característica
• Activar la agrupación en ZIP/PDF (véase la siguiente sección): todos los archivos subidos se convierten en uno solo, que recibe la característica
• Utilizar un campo de archivo sin característica: así se pueden realizar tantas subidas como se desee, pero sin clasificación

**Peculiaridad del navegador de Apple:**En el iPhone, las opciones de selección única desactivadas no se ocultan, sino que se muestran en gris (estándar HTML). Si quieres evitarlo: utiliza «Valores permitidos» (lista blanca) en lugar de desactivar opciones individuales; las opciones no permitidas se eliminarán por completo del menú desplegable.

Agrupar varios archivos

Muy práctico para muchas fotos o varias páginas de PDF:

• Agrupación en ZIP: Todos los archivos subidos se agrupan en un archivo ZIP. Opcionalmente, «solo si hay varios archivos»: uno solo se sube normalmente.
• Agrupación en PDF: varias imágenes o archivos PDF se fusionan en un único PDF.
• Renombrar archivos antes de la agrupación: los nombres de los archivos dentro del ZIP/PDF siguen una plantilla (macros activadas).

Híbrido: carga o descarga

En la configuración de los campos, también puedes configurar un campo de archivo como campo de descarga (para archivos ya existentes en onOffice) o como híbrido (carga + descarga).

Panel de firmas

En la configuración del campo de archivo, marca la casilla «Campo de firma». En lugar del selector de archivos estándar, se muestra en el formulario un panel digital: el visitante firma con el ratón o con el dedo.

• La firma se guarda como PNG en el campo de archivo de onOffice (no como PDF)
• Se trata como un archivo subido (características del documento, pestañas y opciones de marca de agua disponibles)
• Mediante las macros _dateipfadAdressfeld o _dateipfadObjektfeld puedes insertar la firma en plantillas PDF de onOffice: perfecto para declaraciones de los inquilinos, encargos de emergencia, poderes, etc.

> 💡 Opción relacionada: la casilla «Desactivar el archivo adjunto por correo para los archivos de este campo» evita que el PNG de la firma se adjunte adicionalmente al correo de notificación —útil si la firma ya aparece en el PDF del informe y no se debe enviar por duplicado.

📺 Ver vídeo: 9. Añadir campo de firma al formulario

> 📎 Las imágenes HEIC del iPhone se convierten automáticamente a JPEG. > 📎 Límite de tamaño de archivo: 128 MB por archivo individual (límite de nginx del servidor). Si los archivos individuales son más grandes, el usuario recibirá un error del servidor antes de que se realice la subida.

Campos de descarga de archivos

Con los campos de descarga, puedes poner a disposición de los visitantes del formulario archivos ya almacenados en onOffice para su descarga. Práctico para salas de datos/descargas digitales.

📺 Ver vídeo: 12. Descargar archivos

Criterios de selección (¿qué archivo se descarga?)

Puedes elegir entre varios selectores:

• Por característica del documento: característica concreta exacta
• La característica del documento contiene una cadena de caracteres: p. ej., todos los archivos con «Expose» en la característica
• Último archivo con tipo de archivo X
• Último archivo cuyo nombre contenga X
• Último archivo cuyo título contenga X
• Todos los archivos con tipo de archivo X / nombre que contenga X / título que contenga X
• URL externa (almacenada de forma estática)
• Crear PDF a partir de una plantilla de onOffice (Exposé / Carta / Formulario)

Otras opciones

• Renombrar archivo al descargar: Macros activadas — p. ej., Expose_Name_Vorname.pdf
• Ocultar campo si no hay archivo: Si el selector no encuentra ningún archivo adecuado, el campo no se muestra.
• Registrar actividad al descargar: Quién ha descargado qué y cuándo → Registro de actividades en onOffice.

Campos de criterios de búsqueda y complemento regional

Los campos del módulo de criterios de búsqueda deben definirse explícitamente como campos de criterios de búsqueda en la administración de onOffice; de lo contrario, propform no los ofrecerá.

Campos de rango (de/a)

Campos como «Superficie habitable», «Precio de compra» o «Número de habitaciones» tienen en los criterios de búsqueda un valor de inicio y un valor final. Puedes:

• Etiquetas personalizadas: asignar tus propias denominaciones en lugar de «de» / «a» (p. ej., «mín.» / «máx.»).
• Parámetros URL separados: con doble guión bajo — ?searchcriteria[wohnflaeche__von]=50&searchcriteria[wohnflaeche__bis]=80

Caso especial: suplemento regional

El campo de selección múltiple «Suplemento regional» suele tener una estructura de árbol muy extensa (código postal, barrios, regiones). En el modo «Alternativo», los elementos secundarios no se muestran directamente en el formulario, sino que se activan automáticamente al seleccionar el elemento principal. De este modo, el formulario se mantiene rápido y claro.

## Tipos especiales

Encabezado

Texto extenso como encabezado de sección. Macros activadas — p. ej., «Consulta sobre _objektart en _ort».

Descripción

Texto explicativo más extenso, normalmente entre campos. Macros activadas. Dentro de las descripciones puedes utilizar macros de propform como _pfButton(...) o _pfLink(...) para crear botones y enlaces — consulta macros de propform.

> 💡 En los campos de descripción también puedes insertar iFrames, por ejemplo, un iFrame de reserva de citas de Timum. Es muy útil para integrar funciones externas directamente en el formulario.

HTML en los campos de descripción

Los campos de descripción permiten HTML avanzado — filtrado mediante HTMLPurifier (protegido contra XSS, pero configurado de forma generosa):

• Formato de texto: <strong>, <b>, <em>, <i>, <u>, <small>, <mark>, <sub>, <sup>, <s>, <ins>, <del>, <br>, <hr>, <p>, <h1>–<h6>
• Listas: <ul>, <ol> y <li>
• Tablas: <table>, <thead>, <tbody>, <tr>, <th>, <td> (con border, cellpadding, cellspacing, colspan, rowspan)
• Enlaces: <a href="..." target="_blank|_self|_top" class="..." type="...">
• Imágenes: <img src="..." width height alt style>
• Contenedores: <div class style>, <span class style>, <blockquote>, <cite>
• Elementos estructurales HTML5: <section>, <nav>, <article>, <aside>, <header>, <footer>, <address>, <figure>, <figcaption>
• Vídeo: <video controls preload poster> con <source src type>
• iFrames (solo HTTPS, p. ej., para la reserva de citas en Timum, YouTube, etc.) — <iframe src width height title allow allowfullscreen frameborder>
• Atributos CSS style: permitidos de forma generosa (incluidos !important, prefijos de proveedor y propiedades propietarias): puedes establecer colores, tamaños, márgenes, bordes, fondos, Flexbox/Grid, transformaciones, etc.

> 🔒 Seguridad: Las etiquetas <script> y los controladores de eventos (onclick=, onload=, etc.) están bloqueados (protección XSS). Los iFrames solo se permiten a través de HTTPS. Por lo tanto, no puedes introducir código JavaScript arbitrario.

Resolución de macros en campos de descripción: totalmente activa: puedes utilizar _calculate(IF(...)) para contenidos condicionales, incrustar campos del conjunto de datos de forma dinámica o emplear _pfGetSearchCriteriaInformation para tablas de perfiles de búsqueda.

Salto de línea

Divide el formulario en pasos multietapa. Por cada campo de salto de línea:

• Nombre del paso GTM (para Google Tag Manager)

Línea divisoria

Línea visual simple. Sin contenido, solo para la estructura.

Botón de enlace

Botón elegante que enlaza a una URL externa. Puedes añadir a la URL los ID/UUID cargados actualmente, p. ej., «Ir al formulario de seguimiento con los registros recién creados». Opciones:

• Añadir ID/UUID de la propiedad (con tipo)
• Añadir ID/UUID de dirección (con tipo + tipo de contacto)
• Añadir ID de criterio de búsqueda, actividad, tarea, cita o proyecto
• Abrir en una nueva pestaña

Imagen

Imagen incrustada a través de una URL externa.

Vídeo

Vídeo incrustado de YouTube o Vimeo. En Vimeo también se puede especificar el parámetro Privacy-Hash.

Acordeón (sección plegable)

Área desplegable. El contenido puede ser cualquier otro campo. Opciones:

• Título (siempre visible)
• Estado: plegado o desplegado por defecto

Campo ChatGPT

Campo especial para la generación de texto mediante IA: el visitante introduce datos, ChatGPT genera el texto y lo escribe en un campo de onOffice. Esto se configura en los ajustes del formulario, en «Generación de texto ChatGPT».

Campo de conexión de registros

Si tu formulario crea o edita simultáneamente una dirección y un inmueble, necesitas una conexión entre ambos —por ejemplo, «propietario», «comprador», «inquilino», «interesado».

En la configuración del formulario puedes seleccionar una conexión estática. Si necesitas una conexión dinámica (por ejemplo, dependiente de un campo de selección), añade un campo de conexión de registros al formulario.

No importa si eliges el tipo de campo «Inmueble» o «Dirección».

Valores posibles:

> 💡 A menudo querrás combinar el campo de conexión con «Valor obligatorio» + «Ocultar campo», para que el visitante no lo vea, pero la conexión se establezca de todos modos.

Continuar con Rellenar previamente y cargar registros 👉