Constructor de formularios

El constructor es la pantalla donde se crea o se edita un formulario. A la izquierda armas los campos; a la derecha ves la Vista previa tal como se llenará. Solo el administrador la usa.

Dónde está: menú lateral → Formularios → Nuevo formulario (/formularios/nuevo). Para editar: Formularios → Editar en la tarjeta (/formularios/:id).

Recorrido por la pantalla

Parte	Para qué sirve
Crear / Publicar versión	Botón principal. En un formulario nuevo crea la versión 1; en uno existente publica una versión nueva. El subtítulo dice el uso y la versión, por ejemplo «Evidencia en campo · Publicar nueva versión (actual: v2)».
Empezar desde plantilla…	Carga los campos de una plantilla. Predefinidas: Visita comercial, Inspección / checklist, Toma de pedido y Reporte de servicio técnico. Mis plantillas: las que guardó tu empresa.
Guardar como plantilla	Guarda los campos actuales como plantilla de tu empresa.
Exportar XLSForm	Solo en formularios ya creados. Descarga la versión vigente en formato XLSForm.
Nombre del formulario	Nombre con el que aparece en la lista, en la tarea y en el portal.
Título (encabezado)	Encabezado que ve quien lo llena. Si lo dejas vacío se usa el nombre.
¿Quién lo llena?	Solo al crear: El técnico en campo (evidencia de tareas y visitas) o El cliente en el portal (para abrir un ticket).
Ajustes de solicitud	Solo en formularios de solicitud. Ver Formularios de solicitud.
Campo 1, Campo 2…	Una tarjeta por campo con Clave, Tipo, Etiqueta, las opciones del tipo, Requerido y Condiciones y relaciones con otros campos.
Agregar campo	Agrega una tarjeta de campo al final.
Vista previa	El formulario como se verá. Puedes llenarlo para probar condiciones y cálculos; no se guarda nada.

Cómo crear un formulario desde cero

1. Clic en Formularios → Nuevo formulario.
2. Escribe el Nombre del formulario y, si quieres otro encabezado, el Título (encabezado).
3. En ¿Quién lo llena? elige El técnico en campo o El cliente en el portal.
4. En Campo 1 escribe la Clave, elige el Tipo y escribe la Etiqueta.
5. Completa las opciones que pide el tipo (por ejemplo Opciones (separadas por coma)). Ver Tipos de campo.
6. Marca Requerido si es obligatorio.
7. Clic en Agregar campo para el siguiente y repite.
8. Revisa la Vista previa.
9. Clic en Crear.

Cómo empezar desde una plantilla

1. En el constructor, abre Empezar desde plantilla….
2. Elige una plantilla de Predefinidas o de Mis plantillas.
3. Los campos se reemplazan por los de la plantilla (y el nombre, si la plantilla trae uno).
4. Ajusta lo que necesites y clic en Crear o Publicar versión.

Cómo guardar un formulario como plantilla

1. Arma los campos en el constructor.
2. Clic en Guardar como plantilla.
3. Escribe el Nombre de la plantilla y clic en Guardar.

Sale el aviso «Plantilla guardada.» y la plantilla aparece en Mis plantillas.

Cómo editar un formulario y publicar una versión

1. En Formularios, clic en Editar en la tarjeta.
2. Cambia, agrega o elimina campos (botón Eliminar de cada tarjeta).
3. Clic en Publicar versión.

La versión nueva queda vigente para lo que se capture desde ese momento. Las evidencias anteriores conservan su versión.

Cómo exportar un XLSForm

1. Abre el formulario con Editar.
2. Clic en Exportar XLSForm.

Algunos tipos cambian al exportar: Texto largo sale como texto, Catálogo como selección única y Calificación (estrellas) como número entero.

Reglas que conviene conocer

• La Clave es el nombre interno con el que se guarda y se exporta la respuesta. Debe empezar con letra minúscula y llevar solo minúsculas, números y guion bajo (por ejemplo numero_serie). No se puede repetir dentro del formulario (ni dentro del mismo grupo repetible).
• Al guardar se descartan los campos sin Clave o sin Etiqueta.
• No hay botón para reordenar campos: se quedan en el orden en que los agregaste. Para mover uno, elimínalo y vuelve a agregarlo al final, o arma el orden desde una plantilla.
• Cada Publicar versión crea una versión aunque no hayas cambiado nada.
• En formularios de solicitud, los ajustes (¿Quién lo ve en el portal? y Al recibir la solicitud) se pueden guardar sin publicar versión con Guardar ajustes (sin publicar versión).
• Las condiciones, los cálculos y las cascadas solo pueden referirse a campos del mismo formulario (o del mismo grupo repetible). Ver Condiciones y relaciones.

Errores frecuentes

Si algo no cuadra al guardar, el constructor muestra «Datos de entrada inválidos» seguido del detalle entre paréntesis. Los detalles más comunes:

• «El campo ‘…’ (…) requiere opciones o una cascada (depende_de)»: un campo de selección no tiene opciones. Escríbelas en Opciones (separadas por coma).
• «El campo ‘…’ tiene opciones duplicadas»: hay dos opciones iguales.
• «Hay keys de campo duplicadas»: dos campos tienen la misma Clave.
• «El campo calculado ‘…’ requiere una expresión ‘calculo’»: falta la Expresión de cálculo.
• «La matriz ‘…’ requiere ‘filas’ y ‘opciones’ (columnas)»: llena Columnas y Filas.
• «El grupo repetible ‘…’ requiere campos anidados»: agrega al menos un subcampo con Agregar subcampo.
• «El dato del sistema ‘…’ requiere un origen válido»: elige un dato en ¿De dónde sale el dato?.
• «Regex inválida en ‘…’»: la expresión de Regex (opcional) está mal escrita.
• «La condición de ‘…’ referencia un campo inexistente» o «El cálculo de ‘…’ referencia campos inexistentes»: se borró o se renombró un campo que otro usaba. Corrige la condición o el cálculo.
• Un mensaje sobre el patrón ^[a-z][a-z0-9_]*$: la Clave tiene mayúsculas, espacios, acentos o empieza con número.
• «“Equipo del cliente” solo existe en formularios de solicitud»: ese tipo no va en un formulario de evidencia.

Preguntas frecuentes

¿Puedo cambiar un formulario de evidencia a solicitud?

No. ¿Quién lo llena? solo se elige al crear. Crea uno nuevo con el otro uso.

¿Puedo volver a una versión anterior?

No hay botón para eso. Publica una versión nueva con los campos que quieres.

¿La vista previa guarda lo que escribo?

No. Solo sirve para probar.